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本 书 是 一 本 经 典 的 Learning by Doing 的 书籍 。 它 由 Node 社 区 著名 的 Socket.10 作 者 一 一 Guillermo 
Rauch， 通 过 大 量 的 实践 案例 撰写 ， 并 由 Node 社 区 非常 活跃 的 开发 者 一 一 Goddy Zhao 翻 译 而 成 。 

本 书 内 容 主 要 由 对 五 大 部 分 的 介绍 组 成 : Node 核 心 设计 理念 、Node 核 心 模块 API、Web 开 发 、 数 据 库 
以 及 测试 。 从 前 到 后 、 由 表 及 里 地 对 使 用 Node 进 行 Web 开 发 的 每 一 个 环节 都 进行 了 深入 的 讲解 ， 并 且 最 大 
的 特点 就 是 通过 大 量 的 实际 案例 、 代 码 展示 来 剖析 技术 点 ， 讲 解 最 佳 实践 。 
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从 2009 年 Ryan Dahl 着 手 开 发 Node.js 开 始 ， 到 现在 Node 已 经 快 4 岁 了 。 尽 管 它 至 今 还 未 发 
布 1.0 版 本 ， 甚 至 连 alpha 都 还 没有 ， 但 是 Node 这 几 年 的 发 展 大 家 都 是 有 目 共 睹 的 。 越 来 越 多 的 
开发 者 和 公司 开始 尝试 使 用 Node.js: 微软 在 其 Azure 云 上 支持 了 部 署 Node.js 应 用 ， 它 同时 还 
是 Node Windows 版 本 的 主要 贡献 者 ; 雅虎 主 站 大 量 使 用 了 Node; LinkedIn 也 使 用 Node 为 其 移 
动 应 用 提供 服务 器 端 服务 。 除 此 之 外 ，Node 官 方 Wiki 页 面 ( https://github.com/joyent/node/wiki/ 
Projects,-Applications,-and-Companies-Using-Node ) 列 出 了 更 多 在 使 用 Node 的 公司 和 项 目 。 可 
以 说 ，Node 以 其 异步 IO 、 服 务 器 端 JavaScript 的 特点 为 Web 开 发 掀 开 了 新 的 篇 章 。 


然而 ， 尽 管 Node 这 几 年 发 展 神速 ， 但 是 相关 的 书籍 、 资 料 却 很 少 ， 尤 其 在 国内 就 更 是 
寥寥 无 几 。 这 就 让 我 萌发 了 为 国内 Node 爱 好 者 翻译 一 本 Node 书 籍 的 想法 ， 于 是 我 就 想到 了 
SMASHING Node.js: JavaScript Everywhere。 之 所 以 选择 这 本 书 ， 是 因为 : 首先 ， 这 本 书 的 作者 
Guillermo Rauch 在 Node 社 区 非常 有 名 ， 作 为 Socket.IO 的 作者 、Express 的 开发 者 之 一 ， 他 为 社 
区 贡献 了 很 多 质量 很 高 的 Node 模 块 ; 其 次 ， 我 此 前 碰巧 有 幸 受 原 书 出 版 社 WILEY 之 邀 ， 担 任 
了 原 书 的 技术 审 校 ， 所 以 我 对 原 书 内 容 非常 熟悉 ; 最 后 ， 也 是 主要 的 原因 ， 是 因为 这 本 书 有 大 
量 的 实践 案例 ， 我 个 人 始终 认为 学 习 技 术 的 最 佳 方式 就 是 实践 ， 而 且 本 书 中 的 案例 在 阐述 技术 
点 的 同时 ， 还 非常 具有 实践 价值 。 在 上 述 三 点 原因 的 驱使 下 ， 最 终 让 我 决定 向 电子 工业 出 版 社 
引荐 此 书 ， 最 后 也 很 高 兴 出 版 社 能 够 认同 这 本 书 并 决定 引进 此 书 。 


本 书 根据 Web 开 发 的 流程 ， 从 Node 核 心 概念 一 一 事件 轮 询 、V8 中 的 JavaScript 的 介绍 , 
Node 核 心 库 一 一 TCP、HTTP 的 讲解 ， 到 应 用 层 开发 一 一 Connect、Express、Socket.I0 的 实践 ， 
再 到 数据 库 一 一 MongoDB、Redis、MySQL 的 剖析 ， 最 后 到 测试 一 一 Mocha、BDD 的 阐述 ， 每 
个 环节 都 一 一 做 了 深入 的 讲解 。 另 外 ， 本 书 始终 贯穿 了 Learning by Doing 的 理念 ， 每 一 章 都 有 
大 量 的 实践 案例 、 代 码 展示 ， 以 编写 实际 代码 的 方式 让 读者 掌握 技术 、 同 时 教会 读者 如 何 将 其 
运用 到 实际 项 目 中 。 总 的 来 说 ， 本 书 确实 是 一 本 学 习 Node 的 好 书 。 
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最 后 ， 在 本 书 翻译 过 程 中 要 特别 感谢 来 自 淘宝 网 工程 师 一 一 易 剑 HE) 以 及 聚 美 优 品 工 
程 师 一 一 邵 信 衔 给 予 的 帮助 ， 另 外 ， 还 要 感谢 本 书 的 编辑 张 春 雨 和 贾 莉 的 辛苦 工作 ， 以 及 我 太 
太 的 大 力 支 持 。 


希望 本 书 能 够 为 广大 Node 开 发 者 带 来 帮助 ， 谢 谢 ! 





Goddy Zhao ( 赵 静 ) , SuccessFactors ( SAP 子 公司 ) 软件 工程 师 。 毕 业 于 复旦 大 学 ， 先 后 在 IBM、 淘 
宝 工 作 过 ， 专 注 于 企业 级 富 客户 端 Web 应 用 的 开发 ， 擅 长 前 后 端 相 结合 的 技术 解决 方案 。 曾 与 人 合 译 过 
多 本 前 端 图 书 ， 并 曾 在 沪 JS 及 D2 前 端 技术 论坛 担任 过 主持 人 和 演讲 嘉宾 。 
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绝 大 部 分 Web 应 用 都 包含 客户 端 和 服务 器 端 丙 部分。 服务 器 端的 实现 往往 比较 复杂 、 麻 
烦 。 创 建 一 个 简单 的 服务 器 都 要 求 对 多 线程 、 伸 缩 性 以 及 服务 器 部 署 有 专业 的 技术 知识 。 除 
此 之 外 ， 由 于 客户 端 软 件 是 用 HTML 和 JavaScript 来 实现 的 ， 而 服务 器 端 核 心 代码 通常 都 是 用 静 
态 编程 语言 实现 的 ， 所 以 ， 开 发 Web 应 用 经 常会 有 错乱 的 感觉 。 由 于 这 种 前 后 端 开发 语言 的 差 
异 ， 不 得 不 让 开发 者 使 用 多 种 编程 语言 ， 同 时 还 要 对 特定 的 程序 逻辑 事先 做 好 设计 选 型 。 


几 年 前 ， 要 用 JavaScript 来 实现 服务 端 软件 几乎 是 想 都 不 敢 想 的 一 件 事情 。 粳 糕 的 性 能 、 
不 成 熟 的 内 存 管理 以 及 缺乏 操作 系统 层面 的 集成 ， 不 解决 这 些 问题 ，JavaScript 很 难 成 为 一 门 
服务 器 端的 语言 。 作 为 Google Chrome 浏 览 器 的 一 部 分 ， 新 的 V8 引 擎 能 够 解决 前 两 个 问题 。 
V8 是 一 个 开源 的 项 目 ， 通 过 简单 的 API 就 可 以 将 其 集成 进去 。 


Ryan Dahl 洞 察 到 了 这 样 一 个 机 会 ， 可 以 通过 将 V8 内 骨 到 操作 系统 的 集成 层 ， 来 让 
JavaScript 享 受到 底层 操作 系统 的 异步 接口 ， 从 而 实现 将 其 带 到 服务 器 端的 目的 。 这 就 是 Node.js 
的 设计 思路 。 这 么 做 的 好 处 是 显而易见 的 。 程 序 员 们 可 以 在 客户 端 和 服务 器 端 使 用 同样 的 编程 
语言 了 。 JavaScript 动 态 语言 的 特性 使 得 开发 和 试验 服务 器 端 代码 变 得 很 自由 ， 使 得 程序 员 们 
摆脱 了 传统 那 种 又 慢 又 重 的 编程 模式 。 


Node.js 迅 速 蹄 红 , 衍生 了 一 个 强大 的 开源 社区 、 支 持 企业 ， 其 至 还 拥有 属于 自己 的 技术 
会 。 我 把 这 种 成 功 归结 于 它 的 简洁 ， 高 效 ， 同 时 提高 了 编程 生产 力 。 我 很 高 兴 V8 成 为 其 一 
小 部 分 。 


本 书 将 带 着 读者 学 习 如 何 基于 Nodejs 为 Web 应 用 构建 服务 器 端 部 分 ， 同 时 还 会 带 着 大 家 学 
习 如 何 组 织 服务 句 端 异步 代码 以 及 如 何 与 数据 库 进行 交互 。 


好 好 享受 这 本 书 带 来 的 乐趣 吧 ! 


Lars Bak,Virtual Machinist 


介绍 


20094F4E A, Ryan Dahl 在 柏林 的 一 个 JavaScript 大 会 上 宣布 了 一 项 名 为 Node.js ( http:// 
nodejs.org/ ) 的 新 技术 。 有 意思 的 是 ， 出 乎 所 有 参 会 者 的 意料 ， 这 项 技术 居然 不 是 运行 在 浏览 
器 端的 ， 要 知道 浏览 器 端 对 于 JavaScript 来 说 绝对 是 拥有 霸主 地 位 的 ， 这 是 毋庸 置疑 的 。 


这 项 技术 是 关于 在 服务 器 端 运行 JavaScript 的 。 当 时 ， 这 简单 的 一 句 描述 ， 瞬 间 让 听众 眼 
前 一 亮 ， 同 时 也 宣告 了 这 项 新 技术 的 发 布 大 获 成 功 。 


如 果 成 真 的 话 ， 以 后 开发 Web 应 用 就 只 需要 一 种 语言 了 。 


毫 无 疑问 ， 这 是 当时 所 有 人 的 第 一 想法 。 毕 竟 ， 要 开发 一 个 现代 富 客户 端 Web 应 用 ， 必 须 
要 对 JavaScript 非 常熟 悉 和 了 解 ， 然 而 ， 对 于 服务 器 端的 技术 来 说 ， 就 有 很 多 不 同 的 选择 ， 而 
且 都 需要 专业 的 要 求 。 拿 Facebook 来 说 ， 他 们 最 近 透 露 其 总 代码 库 中 JS 的 代码 量 是 服务 器 端 语 
言 PHP 的 四 倍 。 


不 过 Ryan 感 兴趣 的 是 为 大 家 展示 一 个 简洁 又 强大 的 示例 程序 。 他 展示 了 一 个 Node.js 中 的 
“hello world” 程 序 一 一 创建 一 个 Web 服 务 器 。 


var http = require('http'); 

var server = http.createServer(function (req, res) { 
res .writeHead (200) ; 
res.end('Hello world'); 

)); 

server.listen(80); 


这 样 一 个 Web 服 务 器 并 非 只 是 个 “玩具 ”， 相 反 ， 它 是 一 个 高 性 能 的 Web 服 务 器 ， 甚 至 ， 
在 某 些 场景 下 ， 比 现 有 如 Apache 和 Nginx 这 样 的 Web 服 务 器 性 能 还 要 好 。Node.js 被 称 为 是 一 个 
将 设计 网 络 应 用 导向 正确 道路 的 特殊 工具 。 


Node.js 快 速 高 效 的 优点 得 益 于 一 种 叫做 事件 轮 询 (event loop) 的 技术 ， 以 及 其 构建 于 V8 
之 上 ，V8 是 Google 为 Chrome Web 浏 览 器 设计 的 JavaScript 解 释 器 和 虚拟 机 ， 它 运行 JavaScript 非 
常 快 。 


Node.js 改 变 了 Web 开 发 模式 。 你 无 须 再 将 书写 部 署 到 独立 安装 的 Web 服 务 器 中 去 运行 ， 如 
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传统 的 LAMP 模 式 ， 它 通常 包含 了 PHP 环 境 和 Apache 服务器 。 


正如 本 书 正文 中 将 要 介绍 的 ， 获 得 Web 服 务 器 完全 的 控制 权 催生 了 另外 一 类 基于 Node.js 开 
发 的 应 用 : 实时 Web 应 用 。 在 一 个 服务 器 端 和 众多 客户 端 进行 快速 的 数据 传输 ， 在 Node 开 发 中 
变 得 越 来 越 常见 。 这 意味 着 你 既 可 以 创建 更 高 效 的 程序 ， 又 能 成 为 社区 的 一 部 分 ， 推 进 理想 的 
Web 开 发 模式 。 

有 了 Node， 你 就 有 了 主动 权 。 同 时 ， 本 书 也 会 详细 介绍 这 种 能 力 背 后 所 带 来 的 新 的 挑战 
和 责任 。 


目标 
首先 最 重要 的 是 ， 本 书 是 一 本 关于 JavaScript 的 书 。 你 必须 具备 一 定 的 JavaScript 知 识 ， 同 时 ， 
一 开始 我 也 花 了 一 章 来 介绍 JavaScript 的 相关 概念 ， 根 据 我 的 经 验 来 看 ， 这 是 非常 有 帮助 的 。 


正如 你 将 会 学 到 的 ，Node.js 努 力 为 浏览 器 端 开 发 者 提供 一 个 舒服 的 开发 环境 。 有 些 常 用 
的 表达 式 ， 如 setTimeout 和 console.1og， 并 非 语言 标准 的 一 部 分 ， 而 是 浏览 句 添 加 的 ， 
它们 在 Nodejs 中 也 能 使 用 。 


在 你 理 清 思绪 ， 准 备 就 绪 后 ， 就 可 以 开始 Node 之 旅 。 作 为 其 核心 的 一 部 分 ，Node 自 带 了 
很 多 有 用 的 模块 ， 以 及 一 个 名 为 NPM 的 简单 包 管理 器 。 本 书 从 教 你 如 何 仅 使 用 Node 核 心 模块 
构建 应 用 开始 ， 随 后 教 你 使 用 一 些 最 有 用 的 社区 开发 者 基于 Node 开 发 的 模块 来 开发 应 用 ， 这 
些 模 块 都 可 以 通过 NPM 安 装 获 得 。 


在 介绍 如 何 用 专门 设计 的 模块 解决 特定 问题 前 ， 我 通常 会 先 介绍 如 何在 不 使 用 模块 的 情况 
下 解决 此 问题 。 理 解 一 个 工具 最 好 的 方式 就 是 首先 搞 明 白 为 什么 会 有 这 个 工具 。 因 此 ， 在 学 习 
某 个 Web 框 架 前 ， 你 会 先 学 习 为 什么 用 它 要 比 使 用 Node.js 原 生 的 HTTP 模 块 要 好 。 在 学 习 如 何 
使 用 如 SocketIO 的 跨 浏览 器 的 实时 框架 构建 应 用 前 ， 你 会 先 学 习 HTMLS WebSocket 的 缺陷 。 

本 书包 含 大 量 示例 。 这 些 示 例 ， 会 教 你 如 何 一 步 一 步 构建 小 应 用 或 者 测试 不 同 的 API。 本 
书 所 有 的 示例 代码 都 可 以 通过 node 命 令 运行 ， 以 下 是 两 种 不 同 的 使 用 方式 : 

* 通过 node REPL ( Read-Eval-Print Loop ) 。 和 Firebug 或 者 Web 调 试 器 中 的 JavaScript 控 制 
BAW, node REPL 人 允许 你 从 操作 系统 的 命令 行 工具 输入 JavaScript 代 码 ， 按 下 回 车 键 ， 
就 能 执行 。 

* 通过 node 命 令 运行 hode 文 件 。 这 种 方式 要 求 你 使 用 已 有 的 文本 编辑 器 。 我 个 人 推荐 
vim (http://vim.org ) 编辑 器 ， 不 过 ， 任 何 文本 编辑 器 都 是 可 以 的 。 

绝 大 多 数 例子 ， 会 一 步 步 教 你 书写 示例 代码 ， 并 且 ， 首 次 书写 会 讲解 其 代码 含义 。 我 还 会 

带领 你 经 历 不 同 的 考验 以 及 代码 重 构 。 当 到 了 重要 的 里 程 碑 时 ， 我 通常 会 展示 一 个 截图 ， 截 图 


vil 


vill 


介绍 


内 容 取决 于 开发 的 应 用 ， 可 能 是 终端 的 截图 ， 也 可 能 是 浏览 器 端 窗口 的 截图 。 

有 的 时 候 ， 讲 解 这 些 示 例 的 时 候 ， 不 管 考虑 得 多 周全 ， 问 题 可 能 还 是 无 法 避免 。 所 以 ,我 
给 你 提供 了 一 个 资源 列表 来 帮助 你 解决 问题 。 
资源 

要 是 在 阅读 本 书 中 ， 遇 到 问题 ， 可 以 通过 如 下 途径 获得 帮助 。 

要 获得 关于 Node.js 的 问题 的 帮助 ， 可 以 通过 如 下 途径 : 

"Node.js 邮 件 列表 ( http://groups.google.com/group/nodejs ) 。 

= jirc.freenode.net 服 务 器 ，#nodejs 频 道 。 


要 获得 如 socket . io 或 者 express 等 的 特定 项 目的 帮助 ， 可 以 通过 官方 支持 频道 ; 如 果 
没有 ， 可 以 通过 像 Stack Overflow ( http:// stackoverflow.com/questions/tagged/node.js ) 这 样 的 论 
坛 ， 都 会 很 有 帮助 。 


绝 大 多 数 的 Node.js 模 块 都 托管 在 GitHub 上 。 如 果 你 发 现 了 bug， 就 可 以 通过 GitHub 报 给 他 
们 ， 并 贡献 相应 的 测试 用 例 。 


尽力 弄 清楚 你 的 问题 到 底 属于 Node.js 还 是 JavaScript。 这 对 确保 你 寻求 的 Node.js 帮 助 确实 
是 与 Node 相 关 的 问题 很 有 帮助 。 


如 果 就 本 书 中 的 某 个 问题 想 要 讨论 ， 可 以 直接 通过 rauchg@gmail .com 联 系 我 。 


Eb. 
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安装 
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阻塞 与 非 阻塞 IO 
Node 中 的 JavaScript 
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安装 Node.js 比 较 容易 。 其 设计 理念 之 一 就 是 只 维护 少量 的 依赖 ， 这 使 得 编译 、 安 装 Node.js 
变 得 非常 简单 。 

本 章 介 绍 如 何在 Windows、OS X、 以 及 Linux 系 统 下 安装 Node.js。 在 Linux 系 统 下 ， 要 以 编 
译 源 代码 的 方式 进行 安装 .， 得 先 确保 正确 安装 了 其 依赖 的 软件 包 。 


注意 ; 在 本 书 中 ， 若 看 到 代码 片段 前 有 $ 符 号， 就 表示 需要 将 其 代码 输入 到 操作 系统 的 shell 中 。 


在 Windows 下 安装 
Windows 用 户 要 安装 Node.js， 只 需 前 往 其 官网 http:/nodejs.org 下 载 MSI 安 装 包 即 可 。 每 个 
Nodejs 的 发 行 版 都 有 对 应 的 MSI 安 装 包 供用 户 下 载 和 安装 。 


的 安装 指引 进行 安装 即 可 。 


1 译 者 注 : 在 Linux 下 ， 官 方 还 提供 了 二 进 制 包 进行 安装 。 


位 就 是 x64。 
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Welcome to the node.js Setup Wizard 


n d d e The Seno wizarc wil nstai node. s on your comauter. Chick 
Next to contu or Cancel to ext the Setup Wizard 





1-1: Node.js 安 装 指引 
要 验证 是 否 安装 成 功 ， 可 以 打开 shell 或 者 通过 执行 cmd .exe 打 开 命 令 行 工具 并 输入 


$ node -version, 


如 果 安 装 成 功 的 话 ， 就 会 显示 安装 的 Node.js 的 版 本 号 。 


在 OS X^ 
在 Mac 下 和 在 Windows 下 安装 类 似 ， 可 通过 对 应 的 安装 包 进 行 。 从 Node.js 官 网 下 载 PKG 文 


已 安装 了 XCode， 然 后 根据 Linux 下 的 编译 步骤 进行 编译 安装 。 
运行 下 载 好 的 安装 包 ， 并 根据 图 1-2 所 示 的 安装 步骤 进行 安装 。 


22.8 acia aisi uc B OR Mon, dct 


Welcome to the Node Installer 





This package will install node and npm into /usr/local/bin 
© Introduction 
@ License 





图 1-2:， Node.js 安 装 包 
要 验证 是 否 安装 成 功 ， 打 开 shell 或 者 运行 Terminal .app 打 开 终 端 工具 (也 可 以 在 Spotlight 
中 输入 “Terminal” 来 搜索 该 软件 ) ， 接 着 , 输入 $ node -version。 


如 果 安 装 成 功 ， 就 会 显示 安装 的 Node.js 的 版 本 号 。 
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在 Linux 下 安装 
和 直接 用 二 进 制 包 安 装 类 似 ， 编 译 安装 Node.js 也 很 简单 。 要 在 绝 大 多 数 *nix 系 的 系统 中 编 
译 Node.js， 只 需要 确保 系统 中 有 C/C++ 编译 器 以 及 OpenSSL 库 就 可 以 了 。 


要 是 没有 ， 安 装 起 来 也 比较 容易 ， 大 部 分 的 Linux 发 行 版 都 自 带 包 管理 器 ， 通 过 它 可 以 很 « $9] 
方便 地 进行 安装 。 
比方 说 ， 在 Amazon Linux 中 ， 可 以 通过 如 下 命令 来 安装 依赖 包 : 


> sudo yum install gcc gcc-c++ openssl-devel curl 


在 Ubuntu 中 ， 安 装 方式 稍 有 不 同 ， 如 下 所 示 : 


> sudo apt-get install g++ libssl-dev apache2-utils curl 
编译 

在 操作 系统 终端 下 ， 运 行 如 下 命令 : 

注意 : 将 下 面 例子 中 的 ?替换 成 最 新 的 Node.js 的 版 本 号 ”。 


$ ./configure 
$ make 

$ make test 

$ make install 


如 果 make test 命 令 报错 。 我 建议 你 停止 安装 ， 并 将 ./configure、make 以 及 make test 
命令 产生 的 日 志 信息 发 送 给 Node.js 的 邮件 列表 。 
确保 安装 成 功 

打开 终端 或 者 类 似 XTerm 这 样 的 应 用 ， 并 输入 $ node -version, 

如 果 安 装 成 功 的 话 ， 就 会 显示 安装 的 Node.js 的 版 本 号 。 
Node REPL 

要 运行 Node 的 REPL， 在 终端 输入 node 即 可 。 

可 以 试 试 运行 一 些 JavaScript 表 达 式 。 例 如 : 


> Object.keys (global) 
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注意 : 如 果 看 到 本 书 中 的 示例 代码 段 前 有 >， 就 说 明 要 在 REPL 中 输入 。 
REPL 是 我 最 喜欢 的 工具 之 一 ， 它 能 让 我 很 方便 地 验证 一 些 Node API 和 JavaScript API 是 否 
正确 。 若 有 时 忘记 了 某 个 API 的 用 法 ， 就 可 以 用 REPL 来 验证 下 ,非常 有 用 ， 尤 其 是 在 开发 大 
型 模块 的 时 候 。 我 一 般 都 新 开 一 个 单独 的 终端 tatb， 快 速 在 REPL 中 尝试 一 些 JavaScript 的 原生 用 
法 ， 真 的 非常 方便 。 


执行 文件 
和 绝 大 多 数 脚 本 语言 一 样 ，Node.js 可 以 通过 node 命 令 来 执行 Node 脚 本 。 
用 你 喜欢 的 编辑 器 ， 创 建 一 个 名 为 my-web-server .js 的 文件 ， 输入 如 下 内 容 : 


var http = require('http'); 

var serv = http.createServer(function (req, res) { 
res.writeHead(200, ( 'Content-Type': 'text/html' }); 
res.end('«marquee»Smashing Node!</marquee>') ; 

P); 

serv.listen(3000); 


使 用 如 下 命令 来 执行 此 文件 : 


$ node my-web-server.js 


接着 ， 如 图 1-3 所 示 ， 在 浏览 器 中 输入 http:/localhost:3000。 








图 1-3: 使 用 Node 托 管 一 个 简单 的 HTML 文 件 . 

上 述 代码 展示 了 如 何 使 用 Node 书 写 一 个 完整 的 HTTP 服 务 器 ,来 托管 一 个 简单 的 HTML 文 
档 。 这 是 一 个 Node.js 的 经 典 例子 ， 因 为 它 证 明了 Node.js 的 强大 ， 仅 通过 几 行 JavaScript 代 码 就 
能 创建 出 一 个 像 Apache 或 者 HS 的 Web 服 务 器 。 


NPM 
Node 包 管理 器 (CNPM ) 可 以 让 你 在 项 目 中 轻松 地 对 模块 进行 管理 ， 它 会 下 载 指定 的 包 、 


解决 包 的 依赖 、 运 行 测试 脚本 以 及 安装 命令 行 脚本 

尽管 这 些 工 作 并 非 你 项 目的 核心 功能 ， 但 使 用 第 三 方 发 布 的 模块 可 以 提高 项 目的 开发 效率 。 
NPM 本 身 是 用 Node.js 开 发 的 ， 有 二 进 制 包 的 发 布 形式 ( Windows FAMS AR fit, Mac F 
命令 4， 


有 PKG 文 件 ) :从 源码 进行 编译 安装 ， 可 以 使 用 如 下 命令 


过 如 下 命令 可 以 检查 NPM 是 否 安 装 成 功 : 


nom 
npr 


安装 成 功 的 话 ， 会 显示 出 所 安装 NPM 的 版 本 号 


为 了 展示 如 何 通 过 NPM 来 安装 模块 ， 我 们 创建 一 个 my-project 目 录 ， 安装 colors 模 


块 ， 然 后 创建 一 个 index .js 文件 : 


npm 


要 验证 模块 是 否 安装 成 功 ， 可 以 在 该 目录 下 查看 是 否 有 noqe modqules/colors 目 录 


然后 ， 用 你 最 喜欢 的 编辑 器 编辑 index .js 文件 : 


在 该 文件 中 添加 如 下 内 容 : 


运行 此 文件 的 结果 应 该 如 图 1-4 所 示 


eo0 1l. bash 





node index.js 


4 PEATE: 截止 到 本 书 翻译 期 间 ，NPM 会 随 着 Node:js 的 安装 自动 就 安装 好 了 ， 无 须 手动 再 去 安装 NPM， 并 且 http:/ 


nodejs.org/install.sh 脚 本 已 经 被 官方 移 除 





8 PART | 。 从 安装 与 概念 开始 


[2^ 自 定 义 模块 
要 自 定义 模块 ， 你 需要 创建 一 个 package .json 文 件 。 通 过 这 种 方式 来 定义 模块 有 三 种 好 处 : 


= 可 以 很 方便 地 将 项 目 中 的 模块 分 享 给 其 他 人 ， 不 需要 将 整个 hode_modules 目 录 发 给 
他 们 。 因 为 有 了 package.json 之 后 ， 其 他 人 运行 npm install 就 可 以 把 依赖 的 模 
块 都 下 载 下 来 ， 直 接 将 node_modules 目 录 给 别人 根本 就 是 个 馒 主意。 特别 是 当 用 
Git 这 样 的 SCM 系 统 进行 代码 控制 的 时 候 。 

= 可 以 很 方便 地 记录 所 依赖 模块 的 版 本 号 。 举 个 例子 来 说 ， 当 你 的 项 目 通过 npm 
install colors 安 装 的 是 0.5.0 的 colors。 一 年 后 ， 由 于 colors 模 块 API 的 更 改 ， 可 能 
导致 与 你 的 项 目 不 兼 容 ， 如 果 你 使 用 npm install 并 且 不 指定 版 本 号 来 安装 的 话 ， 
你 的 项 目 就 没 法 正常 运行 了 。 

" ”让 分 享 更 简单 。 如 果 你 的 项 目 不 错 ， 你 是 否 想 将 它 分 享 给 别人 ? 这 时 ， 因 为 有 Package . 
json 文 件 ， 通过 npm publish 就 可 以 将 其 发 布 到 NPM 库 中 供 所 有 人 下 载 使 用 了 。 


在 原先 创建 的 目录 (my-project ) 中 ,删除 node_modules 目 录 并 创建 一 个 package .json 
文件 : 


$ rm -r node modules 


$ vim package.json 


然后 ， 将 如 下 内 容 添 加 到 该 文件 中 人 : 


{ 
"name": "my-colors-project" 
, "version": "0.0.1" 
, "dependencies": { 
"colors": "0.5.0" 
) 
) 
注意 : 此 文件 内 容 必 须 遵 循 JSON 格 式 。 仅 遵循 JavaScript 格 式 是 不 够 的 。 举例 来 说 ， 你 必须 要 确保 所 
有 的 字符 串 ， 包 括 属性 名 ， 都 是 使 用 双 引 号 而 不 是 单 引 号 。 


package .json 文 件 是 从 Node.js 和 NPM 两 个 层面 来 描述 项 目的 。 其 中 只 有 name 和 version 
是 必要 的 字段 。 通 常情 况 下 ， 还 会 定义 一 些 依赖 的 模块 ， 通 过 使 用 一 个 对 象 ， 将 依赖 模块 的 模 
块 名 及 版 本 号 以 对 象 的 属性 和 值 将 其 定义 在 package .json 文 件 中 。 

保存 上 述 文件 ， 安 装 依赖 的 模块 ， 然 后 再 次 运行 index .js 文件 : 


$ npm install 
$ node index  # 注意 了 ,这 里 文件 名 不 需要 加 上 “.js” 后 缀 


5 译 者 注 : 不 建议 示例 代码 中 逗号 的 书写 风格 ， 个 人 建议 将 逗号 写 在 行 未 。 
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在 本 例 中 ， 自 定义 模块 是 内 部 使 用 的 。 不 过 ， 如 果 想 发 布 出 去 ，NPM 提 供 了 如 下 这 种 方 
式 ， 可 以 很 方便 地 发 布 模块 : 


$ npm publish 
当 别 人 使 用 require ('my-colors-project') 时 ， 为 了 能 够 让 Node 知 道 该 载 人 哪个 文 
件 ， 我 们 可 以 在 package .json 文 件 中 使 用 main 属 性 来 指定 : 


{ 
"name": "my-colors-project" 
, "version": "0.0.1" 
, "main": "./index" 
, "dependencies": ( 
"colors": *0,5.0* 
) 
) 


当 需 要 让 模块 暴露 API 的 时 候 ，main 属 性 就 会 变 得 尤为 重要 ， 因 为 你 需要 为 模块 定义 一 个 
人 口 (有 的 时 候 ， 入 口 可 能 是 多 个 文件 ) 。 


要 查看 package .json 文 件 所 有 的 属性 文档 ， 可 以 使 用 如 下 命令 : 


$ npm help json 
小 贴 士 ， 如 果 你 不 想 发 布 你 的 模块 ， 那 么 在 package .json 中 加 入 "private": "true", 这 样 可 以 
避免 误 发 布 。 
安装 二 进 制 工具 包 
有 的 项 目 分 发 的 是 Node 编 写 的 命令 行 工 具 。 这 个 时 候 ， 安 装 时 要 增加 -g 标 志 。 
举例 来 说 ， 本 书 中 要 介绍 的 Web 框 架 express 就 包含 一 个 用 于 创建 项 目的 可 执行 工具 。 








$ npm install -g express 


安装 好 后 ， 新 建 一 个 目录 ， 并 在 该 目录 下 运行 express 命 令 : 


$ mkdir my-site 
$ cd mysite 
$ express 


小 贴 士 : 要 想 分 发 此 类 脚本 ， 发 布 时 ， 在 Package .json 文 件 中 添加 "bin": "./path/to/script" 
项 ， 并 将 其 值 指向 可 执行 的 脚本 或 者 二 进 制 文件 。 
浏览 NPM 仓 库 
等 掌握 第 4 章 关 于 Node.js 模 块 系统 的 内 容 后 ， 你 就 能 编写 出 可 以 使 用 Node 生 态 系统 中 任意 
类 型 模块 的 程序 了 。 
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NPM 有 一 个 丰富 的 仓库 ， 包 含 了 上 千 个 模块 。NPM 有 两 个 命令 可 以 用 来 在 仓库 中 搜索 和 
查看 模块 : search 和 view。 

例如 ， 要 搜索 和 realtime 相 关 的 模块 ， 就 可 以 执行 如 下 命令 : 

$ npm search realtime 

该 命令 会 在 已 发 布 模块 的 name 、tags 以 及 description 字 段 中 搜索 此 关键 字 ， 并 返回 匹配 的 
模块 。 

找到 了 感 兴趣 的 模块 后 ， 通 过 运行 hpm view 命令 ， 后 面 紧 跟 该 模块 名 ， 就 能 看 到 package . 
json 文 件 以 及 与 NPM 仓 库 相 关 的 属性 ， 举 个 例子 : 


$ npm view socket.io 

ME: 输入 npm help 可 以 查看 某 个 NPM 命 令 的 帮助 文档 ， 如 npm help publish 就 会 教 你 如 何 

发 布 模块 
小 结 

通过 本 章 的 学 习 ， 你 应 当 已 经 搭建 好 了 Nodejs + NPM 的 环境 。 

除了 能 够 运行 hode 和 npm 命 令 外 ， 你 现在 也 应 当 学 会 了 如 何 执行 简单 脚本 以 及 如 何 声明 
模块 依赖 。 

相信 你 还 学 会 了 Node.js 中 一 个 重要 的 关键 词 require， 它 用 来 载 人 模块 和 系统 API， 在 快 
速 介绍 完 语言 基本 知识 后 ， 第 4 章 中 会 对 这 部 分 内 容 做 着 重 介 绍 。 

最 后 相信 你 了 解 了 NPM 仓 库 ， 它 是 Node.js 模 块 生态 系统 的 人 口 。Node.js 是 开源 项 目 ， 所 
以 大 部 分 Node.js 编 写 的 程序 也 都 是 开源 的 ， 供 其 他 人 重用 。 


CHAPTER 


JavaScript 概 览 





A. 4D 
JV A 
JavaScript 是 基于 原型 、 面 向 对 象 、 弱 类 型 的 动态 脚本 语言 。 它 从 函数 式 语 言 中 借鉴 了 一 C1] 
些 强 大 的 特性 ， 如 闭 包 和 高 阶 函 数 ， 这 也 是 JavaScript 语 言 本 身 有 意思 的 地 方 。 
从 技术 层面 上 来 说 ，JavaScript 是 根据 ECMAScript 语 言 标准 来 实现 的 。 这 里 有 一 点 非常 重 
Xi. 由 于 Node 使 用 了 V8 的 原因 ， 其 实现 很 接近 标准 ， 另 外 ， 它 还 提供 了 一 些 标准 之 外 实用 的 
附加 功能 。 换 名 话说 ， 在 Node 中 书写 的 JavaScript 和 浏览 器 上 口碑 不 是 很 好 的 JavaScript 有 着 重 
要 的 不 同 。 
另外 ，Node 中 你 书写 的 绝 大 多 数 JavaScript 代 码 都 符合 Douglas Crockford 在 他 那 本 著名 的 书 
《JavaScript 语 言 精粹 》 中 提 到 的 JavaScript 语 言 的 “精粹 ”。 
本 章 分 为 以 下 两 个 部 分 : 
* JavaScript 基础 。 语 言 基础 。 适 用 于 : Node、 浏 览 器 以 及 语言 标准 。 
= V8 中 的 JavaScript。V8 提 供 的 一 些 特性 是 浏览 器 不 支持 的 ，IE 就 更 不 用 说 了 ， 因 为 这 
些 特性 是 最 近 才 纳入 标准 的 。 除 此 之 外 ，V8 还 提供 一 些 非 标 准 的 特性 ， 它 们 能 辅助 解 
决 一 些 常见 的 基本 需求 。 
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除 此 之 外 ， 下 一 章 还 会 介绍 Node 中 对 语言 的 扩展 和 特性 。 


JavaScript fil 


本 章 默认 你 对 JavaScript 及 其 语法 有 一 定 的 了 解 。 本 章 会 介绍 学 习 Node.js 必 须要 掌握 的 


JavaScript 基 础 知识 。 


值 ， 


JavaScript 类 型 可 以 简单 地 分 为 两 组 : 基本 类 型 和 复杂 类 型 。 访 问 基本 类 型 ， 访 问 的 是 
而 访问 复杂 类 型 ， 访 问 的 是 对 值 的 引用 。 
= 基本 类 型 包括 number、boolean、string、null 以 及 undefined。 


= 复杂 类 型 包括 array、function 以 及 object。 


如 下 述 例子 所 示 : 
// 基本 类 型 


var a= 5 
var b = a; 

b = 6; 

a; // 结果 为 5 
b; // 结果 为 6 


// 复杂 类 型 
var a = ['hello', 'world']; 
var b = a; 

b[0] = 'bye'; 

a[0]; // 结果 为 “bye” 

b[0]; // 结果 为 “bye” 


上 述 例子 中 的 第 二 部 分 ，b 和 a 包含 了 对 值 的 相同 引用 。 因 此 ， 当 通过 b 修 改 数组 的 第 一 个 


元 素 时 ，a 相 应 的 值 也 更 改 了 ， 也 就 说 a[0] === b[0]。 


小 
-大 


型 的 困惑 
要 在 JavaScript 中 准确 无 误 地 判断 变量 值 的 类 型 并 非 易 事 。 
因为 对 于 绝 大 部 分 基本 类 型 来 说 ，JavaScript 与 其 他 面向 对 象 语言 一 样 有 相应 的 构造 器 ， 


比方 说 ， 你 可 以 通过 如 下 两 种 方式 来 创建 一 个 字符 串 : 


var a = 'woot'; 
var b - new String('woot'); 


a+b; // ‘woot woot' 


然而 ,要 是 对 这 两 个 变量 使 用 typeof 和 instanceof 操 作 符 ， 事情 就 变 得 有 意思 了 : 
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typeof a; // 'string' 
typeof b; // 'object' 
a instanceof String; // false 


b instanceof String; // true 


而 事实 上 ， 这 两 个 变量 值 绝对 都 是 货真价实 的 字符 串 : 
a.substr == b.substr; // true 
并 且 使 用 == 操 作 符 判定 时 两 者 相等 ， 而 使 用 === 操 作 符 判定 时 并 不 相同 : 


= b; // true 
== b; // false 


考虑 到 有 此 差异 ， 我 建议 你 始终 通过 直观 的 方式 进行 定义 ， 避 免 使 用 new。 
有 一 点 很 重要 ， 在 条 件 表达 式 中 ， 一 些 特定 的 值 会 被 判定 为 false: null, undefined, ' ', 
还 有 0 : 


var a = 0; 
if (a) { 

// 这 里 始终 不 会 被 执行 到 
} 
a == false; // true 
a === false; // false 


另外 值得 注意 的 是 ，typeof 不 会 把 nul1 识 别 为 类 型 为 null: 

typeof null == 'object'; // 很 不 幸 ， 结 果 为 tme 

数组 也 不 例外 ， 就 算是 通过 [] 这 种 方式 定义 数组 也 是 如 此 : 

typeof [] == 'object'; // true 

这 里 要 感谢 V8 给 我 们 提供 了 判定 是 否 为 数组 类 型 的 方式 ， 能 够 让 我 们 免 于 使 用 hack 的 方式 。 


在 浏览 器 环境 中 ， 我 们 通常 要 查看 对 象 内 部 的 [[Class]] 值 : Object.prototype. 
toString.call([]) == '[object Array]'。 该 值 是 不 可 变 的 ， 有 利于 我 们 在 不 同 的 
上 下 文中 (如 浏览 器 窗口 ) 对 数组 类 型 进行 判定 ， 而 instanceof Array 这 种 方式 只 适用 于 
与 数组 初始 化 在 相同 上 下 文中 才 有 效 。 


JavaScript, KÄRJE. 
它们 都 属于 一 等 函数 : 可 以 作为 引用 存储 在 变量 中 ， 随 后 可 以 像 其 他 对 象 一 样 ， 进 行 传 


var a = function () {} 


console.log(a); // 将 函数 作为 参数 传递 
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JavaScript 中 所 有 的 函数 都 可 以 进行 命名 。 有 一 点 很 重要 ， 就 是 要 能 区 分 出 子 数 名 和 变量 名 。 


var a = function a () { 
'function' == typeof a; // true 
): 


THIS. FUNCTION#CALLLA R FUNCT ION#APPLY 
下 述 代码 中 函数 被 调用 时 ，this 的 值 是 全 局 对 象 。 在 浏览 器 中 ， 就 是 window 对 象 : 


function a () { 
window == this; // true; 
}; 


a(); 
调用 以 下 函数 时 ,使 用 .call 和 .apply 方 法 可 以 改变 this 的 值 : 
function a () { 
this.a == 'b'; // true 
) 
a.call(( a: 'b' )); 


call 和 apply 的 区 别 在 于 ，call 接 受 参数 列表 ， 而 apply 接 受 一 个 参数 数组 : 


function a (b, c) { 


b == 'first'; // true 
c == 'second'; // true 
) 
a.call(( a: 'b' ), 'first', 'second') 
a.apply(( a: 'b' }, ['first', 'second']); 
— sk eL. xu. Em 


函数 有 一 个 很 有 意思 的 属性 一 一 参数 数量 ， 该 属性 指明 函数 声明 时 可 接收 的 参数 数量 。 在 
JavaScript 中 ， 该 属性 名 为 length: 


var a = function (a, b, c); 
a.length == 3; // true 


尽管 这 在 浏览 器 端 很 少 使 用 ， 但 是 ， 它 对 我 们 非常 重要 ， 因 为 一 些 流行 的 Node.js 框 架 就 
是 通过 此 属性 来 根据 不 同 参数 个 数 提供 不 同 的 功能 的 。 
闭 包 

在 JavaScript 中 ， 每 次 函数 调用 时 ， 新 的 作用 域 就 会 产生 。 


在 某 个 作用 域 中 定义 的 变量 只 能 在 该 作用 域 或 其 内 部 作用 域 (该 作用 域 中 定义 的 作用 域 ) 
中 才能 访问 到 : 
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var a = 5; 
function woot () { 
a == 5; // true 


var a = 6; 


function test () { 
a == 6; // true 
} 


test (); 
); 


woot (); 
自 执行 函数 是 一 种 机 制 ， 通 过 这 种 机 制 声明 和 调用 一 个 匿名 函数 ， 能 够 达到 仅 定义 一 个 新 
作用 域 的 作用 。 


var a = 3; 
(function () { 
var a = 5; 


HO; 


a == 3 // true; 


自 执行 函数 对 声明 私有 变量 是 很 有 用 的 ， 这 样 可 以 让 私有 变量 不 被 其 他 代码 访问 。 


tk 
: 


JavaScript 中 没有 class 关 键 词 。 类 只 能 通过 函数 来 定义 : 


function Animal () { } 
要 给 所 有 Animal 的 实例 定义 函数 ， 可 以 通过 prototype 属 性 来 完成 : 
Animal.prototype.eat = function (food) { 


// eat method 


H 
i 


这 里 值得 一 提 的 是 ， 在 prototype 的 函数 内 部 ，this 并 非 像 普通 函数 那样 指向 global 对 象 ， 
而 是 指向 通过 该 类 创建 的 实例 对 象 : 


function Animal (name) { 
this.name = name; 


) 


Animal.prototype.getName () ( 
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return this.name; 


ES 


var animal = new Animal('tobi'); 


a.getName() -- 'tobi'; // true 
JavaScript 有 基于 原型 的 继承 的 特点 。 通 常 ， 你 可 以 通过 以 下 方式 来 模拟 类 继承 。 
定义 一 个 要 继承 自 animal1 的 构造 器 : 


function Ferret () { }; 

要 定义 继承 链 ， 首 先 创建 一 个 animal 对 象 ， 然 后 将 其 赋值 给 Ferret .prototype, 
// 实现 继承 

Ferret .nrototvne = new Animal(): 


随后 ， 可 以 为 子 类 定义 属性 和 方法 : 


// 为 所 有 ferrets 实 例 定义 type 属 性 


Ferret.prototype.type = 'domestic'; 


[21 5 还 可 以 通过 prototype 来 重 写 和 调用 父 类 函数 : 


Ferret.prototype.eat = function (food) { 
Animal.prototype.eat.call(this, food); 


/ ferret 特有 的 人 逻辑 写 在 这 里 


这 项 技术 很 赞 。 它 是 同类 方案 中 最 好 的 〈 相 比 其 他 函数 式 技 巧 ) ， 而 且 它 不 会 破坏 
instanceof 操 作 符 的 结果 : 


var animal = new Animal(); 
animal instanceof Animal // true 


animal instanceof Ferret // false 


var ferret = new Ferret(); 
ferret instanceof Animal // true 


ferret instanceof Ferret // true 


它 最 大 的 不 足 就 是 声明 继承 的 时 候 创 建 的 对 象 总 要 进行 初始 化 〈Ferret.Prototype = new 
Animal ) ， 这 种 方式 不 好 。 tr 


function Animal (a) { 
if (false !== a) return; 


/ 初始 化 
} 


Ferret.prototype = new Animal (false) 
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另外 一 个 办 法 就 是 再 定义 一 个 新 的 空 构造 器 ， 并 重 写 它 的 原型 : 


function Animal () { 
// constructor stuff 


} 


function f () {}; 
f.prototype = Animal.prototype; 
Ferret.prototype - new f; 


幸运 的 是 ，V8 提 供 了 更 简洁 的 解决 方案 ， 本 章 后 续 部 分 会 做 介绍 。 


TRY { CATCH {} 
try/catch 人 允许 进行 异常 捕获 。 下 述 代码 会 抛 出 异常 : 


> var a = 5; 
> a() 
TypeError: Property 'a' of object #<Object> is not a function 


当 函 数 抛 出 错误 时 ， 代 码 就 停止 执行 了 : 


function () { 
throw new Error('hi'); 
console.log('hi'); // 这 里 永远 不 会 被 执行 到 
} 


若 使 用 try/catch 则 可 以 进行 错误 处 理 ， 并 让 代码 继续 执行 下 去 : 


function () { 
var a = 5; 
try { 
a(); 
) catch (e) ( 
e instanceof Error; // true 


) 


console.log('you got here!'); 
) 


v8 中 的 JavaScript 
至 此 ， 你 已 经 了 解 了 JavaScript 在 绝 大 多 数 环境 下 ( 包括 早期 浏览 器 中 ) 的 语言 特性 。 
随 着 Chrome 浏 览 器 的 发 布 ， 它 带 来 了 一 个 全 新 的 JavaScript 引 擎 一 一 V8， 它 以 极速 的 执行 


环境 ， 加 之 时 刻 保持 最 新 并 支持 最 新 ECMAScript 特 性 的 优势 ， 快 速 地 在 浏览 器 市 场 中 占据 了 
重要 的 位 置 。 


其 中 有 些 特性 弥补 了 语言 本 身 的 不 足 。 另 外 一 部 分 特性 的 引入 则 要 归功 于 像 jQuery 
和 PrototypeJS 这 样 的 前 端 类 库 ， 因 为 它们 提供 了 非常 实用 的 扩展 和 工具 ， 如 今 ， 很 难 想象 
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JavaScript 中 要 是 没有 了 这 些 会 是 什么 样子 。 


本 章 介 绍 V8 中 最 有 用 的 特性 ， 并 使 用 这 些 特性 书写 出 更 精准 、 更 高 效 的 代码 ， 与 此 同 
时 ， 代 码 的 风格 也 将 借鉴 最 流行 的 Nodejs 框 架 和 库 的 代码 风格 . 


OBJECT#KEYS 
要 想 获取 下 述 对 象 的 键 (a 和 c ) : 
var a={a: 'b', c: 'd' ); 
通常 会 使 用 如 下 迭代 的 方式 : 


for (var i in a) { } 


通过 对 键 进行 迭代 ， 可 以 将 它们 收集 到 一 个 数组 中 。 不 过 ， 如 果 采 用 如 下 方式 对 Object. 
prototype 进 行 过 扩展 : 


Object.prototype.c = 'd'; 


为 了 避免 在 迭代 过 程 中 把 c 也 获取 到 ， 就 需要 使 用 hasOwnProperty 来 进行 检查 : 


for (var i in a) { 
if (a.hasOwnProperty(i)) () 
) 


在 V8 中 ， 要 获取 对 象 上 所 有 的 自 有 键 ， 还 有 更 简单 的 方法 : 


var & = € ar '"b', GF “a” NH 
Object.keys(a); // ['a', 'c'] 
ARRAYS ISARRAY 


正如 你 此 前 看 到 的 ， 对 数组 使 用 typeof 操 作 符 会 返回 object。 然 而 大 部 分 情况 下 ,我 
们 要 检查 数组 是 否 真 的 是 数组 。 


Array.isArray 对 数组 返回 true， 对 其 他 值 则 返回 false: 


Array.isArray(new Array) // true 
Array.isArray([{]) // true 
Array.isArray(null) // false 
Array.isArray(arguments) // false 


inc 


方法 
要 遍历 数组 ， 可 以 使 用 forEach ( 类似 jQuery 的 $ .each ) : 


^! 会 打印 出 1, 2. 3 
{1, 2, 3].forEach(function (v) { 














console. logiv); 
H; 
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要 过 滤 数 组 元 素 ， 可 以 使 用 filter (类 似 jQuery 的 $.grep ) : 
[1, 2, 3].forEach(function (v) { 
return v < 3; 
D; // 会 返回 [1,2] 
要 改变 数组 中 每 个 元 素 的 值 ， 可 以 使 用 map (类似 jQuery 的 $ .map ) : 


[5, 10, 15] .map(function (v) { 
return v * 2; 
5; // 会 返回 [10, 20, 30] 


V8 还 提供 了 一 些 不 太 常用 的 方法 ， 如 reduce、reduceRight 以 及 lastIndex0Of。 


字符 串 方 法 
要 移 除 字符 串 首 末 的 空格 ， 可 以 使 用 : 
hello '.trim(); // 'hello' 
JSON 


V8 提 供 了 soN. stringify 和 JSON.parse 方 法 来 对 JSON 数 据 进行 解码 和 编码 。 
JSON 是 一 种 编码 标准 ， 和 JavaScript 对 象 字 面 量 很 相近 ， 它 用 于 大 部 分 的 Web 服 务 和 API 


服务 : 
var obj = JSON.parse('{"a":"b"}') 
obj.a == 'b'; // true 
FUNCTION#BIND 
.bind (类 似 jQuery 的 $.proxy ) 允许 改变 对 this 的 引用 : 
function a () { 
this.hello == 'world'; // true 


}; 


var b = a.bind(( hello: 'world' )); 
b); 


FUNCTION#NAME 
V8 还 支持 非 标准 的 函数 属性 名 : 


var a = function woot () {}; 


a.name == 'woot'; // true 


该 属性 用 于 V8 内 部 的 堆栈 追踪 。 当 有 错误 抛 出 时 ，V8 会 显示 一 个 堆栈 追踪 的 信息 ， 会 告 
诉 你 是 哪个 函数 调用 导致 了 错误 的 发 生 : 


> var woot = function () { throw new Error(); }; 
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> woot () 
Error 
at [object Context] :1:32 


[25 > 在 上 述 例子 中 ，V8 无 法 为 函数 引用 指派 名 字 。 然 而 ， 如 果 对 函数 进行 了 命名 ， 
显示 堆栈 追踪 信息 时 将 名 字 显 示 出 来 : 


> var woot = function buggy () { throw new Error(); }; 
> woot () 
Error 


at buggy ([object Context] :1:34) 


为 函数 命名 有 助 于 调试 ， 因 此 ， 推 荐 始终 对 函数 进行 命名 。 


_PROTO_ (继承) 
proto 使 得 定义 继承 链 变 得 更 加 容易 : 


function Animal () { } 
function Ferret () { } 
Ferret.prototype.__proto__ = Animal.prototype; 


这 是 非常 有 用 的 特性 ， 可 以 免 去 如 下 的 工作 : 
= 像 上 一 章节 介绍 的 ， 借 助 中 间 构 造 器 。 
* 借助 OOP 的 工具 类 库 。 无 须 再 引入 第 三 方 模块 来 进行 基于 原型 继承 的 声明 。 


FRE 


v8 就 能 在 


你 可 以 通过 调用 方法 来 定义 属性 ， 访 问 属性 就 使 用 defineGetter _、 设置 属性 就 使 用 


. defineSetter 5 


比如 ， 为 Date 对 象 定义 一 个 称 为 ago 的 属性 ， 返 回 以 自然 语言 描述 的 日 期 间隔 。 


很 多 时 候 ， 特 别 是 在 软件 中 ， 想 要 用 自然 语言 来 描述 日 期 距离 某 个 特定 时 间 点 的 时 间 间 
隔 。 比 如 ，“ 某 件 事 情 发 生 在 三 秒 钟 前 ”这 种 表达 ， 远 要 比 “ 某 件 事情 发 生 在 x 年 x 月 x 日 ”这 


种 表达 更 容易 理解 。 


下 面 的 例子 ， 为 所 有 的 Date 实 例 都 添加 了 ago 获取 器 ， 它 会 返回 以 自然 语言 描述 的 日 期 
距离 现在 的 时 间 间 隔 。 简 单 地 访问 该 属性 就 会 调用 事先 定义 好 的 函数 ， 无 须 显 式 调 用 。 


// 基于 John Resig 的 prettyDate ( 遵循 MIT 协 议 ) 


Date.prototype.  defineGetter  ('ago', function () ( 
var diff - (((new Date()).getTime() - this.getTime()) / 1000) 
, day diff - Math.floor(diff / 86400); 
return day diff -- 0 && ( 


diff « 60 && "just now" || 
diff « 120 && "1 minute ago" || 
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diff < 3600 && Math. floor ( diff / 60 ) + " minutes ago" || 
diff « 7200 && "1 hour ago" || 
diff « 86400 && Math.floor( diff / 3600 ) + " hours ago") || 


day diff -- 1 && "Yesterday" || 

day diff < 7 && day diff + " days ago" || 

Math.ceil( day diff / 7 ) + " weeks ago"; 
P): 


然后 ， 简 单 地 访问 ago 属性 即 可 。 注 意 ， 访 问 属性 实际 上 还 会 调用 定义 的 函数 ， 只 是 这 个 
过 程 透 明了 而 已 : 


var a = new Date('12/12/1990'); // my birth date 
a.ago // 1071 weeks ago 


小 结 
理解 掌握 本 章 的 内 容 对 了 解 语言 本 身 的 不 足以 及 大 多 数 糟糕 的 JavaScript 运 行 环境 ， 如 老 
版 本 的 浏览 器 ， 至 关 重 要 。 


由 于 JavaScript 多 年 来 自身 发 展 缓慢 且 多 少 有 种 被 人 忽略 的 感觉 ， 许 多 开发 者 投入 了 大 量 
的 时 间 来 开发 相应 的 技术 以 书写 出 更 高 效 、 可 维护 的 JavaScript 代 码 ， 同 时 也 总 结 出 了 JavaScript 
一 些 诡异 的 工作 方式 。 

V8 做 了 一 件 很 酶 的 事情 ， 它 始终 坚定 不 移 地 实现 最 新 版 本 的 ECMA 标 准 。Node.js 的 核心 
团队 也 是 如 此 ， 只 要 你 安装 的 是 最 新 版 本 的 Node， 你 总 能 使 用 到 最 新 版 本 的 V8。 它 开启 了 服 
务 器 端 开 发 的 新 篇 章 ， 我 们 可 以 使 用 它 提供 的 更 易 理 解 且 执行 效率 更 高 的 API。 

希望 通过 本 章 的 学 习 ， 你 已 掌握 了 Node 开 发 者 常用 的 一 些 特 性 ， 这 些 特性 是 诸多 未 来 
JavaScript 拥 有 的 特性 中 的 一 部 分 。 
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CHAPTER 


阻塞 与 
非 阻塞 IO 





绝 大 多 数 对 Node.js 的 讨论 都 把 关注 点 放 在 了 其 处 理 高 并 发 的 能 力 上 。 简 单 来 说 ， 相 比 其 
他 同类 解决 方案 ，Node 框 架 给 开发 者 提供 了 构建 高 性 能 网 络 应 用 的 强大 能 力 ， 当 然 ， 开 发 者 
要 明白 Node 内 部 所 做 出 的 权衡 ， 以 及 用 Node 构 建 应 用 之 所 以 性 能 好 的 原因 。 


能 力 越 强 ， 责 任 就 越 大 
Node 为 JavaScript 引 入 了 一 个 复杂 的 概念 ， 这 在 浏览 器 端 从 未 有 过 : 共享 状态 的 并 发 。 事 
实 上 ， 这 种 复杂 度 在 像 Apache 与 nod_php 或 者 Nginx 与 FastCGI 这 样 的 Web 应 用 开发 模型 下 都 从 
未 有 过 。 
通俗 讲 ，Node 中 ， 你 需要 对 回调 函数 如 何 修 改 当前 内 存 中 的 变量 ( 状态 ) 特别 小 心 。 除 
此 之 外 ， 你 还 要 特别 注意 对 错误 的 处 理 是 否 会 潜在 地 修改 这 些 状态 ， 从 而 导致 了 整个 进程 不 可 
用 。 
为 了 更 好 地 掌握 这 个 概念 ， 我 们 来 看 如 下 的 函数 ， 该 函数 在 每 次 请 求 /books URL 的 时 候 
都 会 被 执行 。 假 设 这 里 的 “状态 ”就 是 存放 图 书 的 数组 ， 该 数组 用 来 将 图 书 列表 以 HTML 的 形 
式 返 回 给 客户 端 。 
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var books = [ 
‘Metamorphosis' 
, ‘Crime and punishment' 


l: 


function serveBooks () ( 
// 给 客户 端 返 回 HTML 代 码 


var html = '<b>' + books.join('</b><br><b>') + '</b>'; 


// 恶魔 出 现 了 ， 把 状态 修改 了 ! 
books = []; 


return html; 


} 


等 价 的 PHP 代 码 为 : 


$books = array( 
'Metamorphosis' 
, ‘Crime and punishment ' 
) ; 


function serveBooks () { 
$html = '«b»' . join($books, '«/b»«br»«b»') . '</b>'; 
$books = array(); 
return $html; 

} 


注意 ， 在 上 述 两 例 serveBooks 函 数 中 ， 都 将 books 数 组 重 置 了 。 


现在 假设 一 个 用 户 分 别 向 Node 服 务 器 和 PHP 服 务 器 各 同时 发 起 两 次 对 /books 的 请 求 。 试 
着 预测 下 ， 两 者 结果 会 是 如 何 : 
* Node 会 将 完整 的 图 书 列表 返回 给 第 一 个 请 求 ， 而 第 二 个 请 求 则 返回 一 个 空 的 图 书 列 
表 。 
= PHP 都 能 将 完整 的 图 书 列表 返回 给 两 个 请 求 。 


两 者 区 别 就 在 于 基础 架构 上 。Node 采 用 一 个 长 期 运行 的 进程 ， 相 反 ，Apache 会 产 出 多 
个 线程 ( 每 个 请 求 一 个 线程 ) ， 每 次 都 会 刷新 状态 。 在 PHP 中 ， 当 解释 器 再 次 执行 时 ， 变 量 
$books 会 被 重新 赋值 ， 而 Node 则 不 然 ，serveBooks 函 数 会 再 次 被 调用 ， 且 作用 域 中 的 变量 
不 受 影响 ( 此 时 $books 数 组 仍 为 空 ) 。 
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十 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
| APACHE | 
+-+-------- 十 一 一 一 一 一 一 一 一 十 一 十 
| | | 
十 一 一 一 十 | 十 一 一 一 十 
呈 二 一 二 一 中 一 一 一 一 目 再 一 一 一 一 机 一 一 一 一 二。 二 一 = 二 一 中 一 一 一 一 十 
| PHP | | PHP | | PHP 
| | | | | | 
| THREAD | | THREAD | | THREAD | 
+ 一 一 一 一 十 一 一 一 一 二 不 一 一 一 一 二 一 一 一 一 十 二 一 一 一 一 中 一 一 一 一 站 
| | | 
+--------- + 4--------- + +--------- 十 
| REQUEST | | REQUEST | | REQUEST | 
+--------- + +--------- + č +--------- + 
ad 
能 力 越 强 ， 责 任 也 就 越 大 。 
二 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 十 
| 
| [> 
| NODE.JS | 
| 
| PROCESS 
| | 
| | 
| 
中 一 一 一 一 个 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 一 一 一 一 一 一 一 一 十 一 一 一 一 十 
| | | 
中 一 一 一 一 一 一 一 一 一 + 十 一 一 ~ 一 一 一 一 一 一 + 十 一 一 一 一 一 一 一 一 一 十 
| REQUEST | | REQUEST | | REQUEST | 
十 一 一 一 一 一 一 一 一 一 十 “+ 一 一 一 一 一 一 一 一 一 + €--------- * 


始终 牢记 这 点 对 书写 出 健壮 的 Nodejs 程 序 ， 避 免 运 行 时 错误 是 非常 重要 的 。 
另外 还 有 重要 的 一 点 是 要 和 弄 清 楚 阻塞 和 非 阻 塞 IO。 


阻塞 
尝试 区 分 下 面 PHP 代 码 和 Node 代 码 有 什么 不 同 : 


// PHP 


print ('Hello'); 
sleep(5); 
print ('World'); 


Node 代 码 示例 : 


// node 
console.log('Hello'); 
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setTimeout(function () ( 
console.log('World'); 
), 5000); 


上 述 两 段 代码 不 仅仅 是 语义 上 的 区 别 ( Node.js 使 用 了 回调 函数 ) ， 两 者 区 别 集中 体现 在 
阻塞 和 非 阻塞 的 区 别 上 。 在 第 一 个 例子 中 ，PHP sleep () 阻 寨 了 线程 的 执行 。 当 程序 进入 睡 
眠 时 ， 就 什么 事情 都 不 做 了 。 

而 Node.js 使 用 了 事件 轮 询 ， 因 此 这 里 setTimeout 是 非 阻塞 的 。 

换 名 话说， 如果 在 setTimeout 后 再 加 入 console. 1og 语 名 的话， 该 语句 会 被 立刻 执行 : 


console.log('Hello'); 


setTimeout (function () { 
console.log('World'); 
}, 5000); 


console.log('Bye'); 


// 这 段 脚本 会 输出 ; 
// Hello 

// Bye 

// World 


采用 了 事件 轮 询 意 味 着 什么 呢 ? 从 本 质 上 来 说 ，Node 会 先 注 册 事 件 ， 随 后 不 停 地 询问 内 
核 这 些 事件 是 否 已 经 分 发 。 当 事件 分 发 时 ， 对 应 的 回调 函数 就 会 被 触发 ， 然 后 继续 执行 下 去 。 
如 果 没 有 事件 触发 ， 则 继续 执行 其 他 代码 ， 直 到 有 新 事件 时 ， 再 去 执行 对 应 的 回调 函数 。 


相反 ,在 PHP 中 ，sleep 一 旦 执行 ， 执 行 会 被 阻塞 一 段 指定 的 时 间 ， 并 且 在 阻塞 时 间 未 达 
到 设 定时 间 前 ， 不 会 有 任何 操作 ， 也 就 是 说 这 是 同步 的 。 和 阻塞 相反 ，setTimeout 仅 仅 只 是 
注册 了 一 个 事件 ， 而 程序 继续 执行 ， 所 以 ， 这 是 异步 的 。 


Node 并 发 实现 也 采用 了 事件 轮 询 。 与 timeout 所 采用 的 技术 一 样 ， 所 有 像 http 、net 这 样 
BDO 的 原生 模块 中 的 IO 部 分 也 都 采用 了 事件 轮 询 技术 。 和 timeout 机 制 中 Node 内 部 会 不 停 地 等 待 ， 
并 当 超 时 完成 时 ， 触 发 一 个 消息 通知 一 样 ，Node 使 用 事件 轮 询 ， 触 发 一 个 和 文件 描述 符 相关 
的 通知 。 
文件 描述 符 是 抽象 的 句柄 ， 存 有 对 打开 的 文件 、socket、 管 道 等 的 引用 。 本 质 上 来 说 ， 当 
Node 接 收 到 从 浏览 器 发 来 的 HTTP 请 求 时 ， 底 层 的 TCP 连 接 会 分 配 一 个 文件 描述 符 。 随 后 ， 如 
果 客 户 端 向 服务 器 发 送 数据 ，Node 就 会 收 到 该 文件 描述 符 上 的 通知 ， 然 后 触发 JavaScript 的 回 
调 函 数 。 


时 ， 


有 一 点 很 重要 ，Node 是 单线 程 的 。 在 没有 第 三 方 模块 的 帮助 下 是 无 法 改变 这 一 事实 的 
为 了 证 明 这 一 点 ， 以 及 展示 它 和 事件 轮 询 之 间 的 关系 ， 我 们 来 看 如 下 例子 : 


上 述 两 段 setTimeout 代 码 , 会 打印 出 timeout 设 置 与 最 终 回 调 函 数 执行 时 ， 两 者 的 时 间 
， 以 毫秒 为 单位 。 如 图 3-1 所 示 是 我 电脑 上 打印 出 的 结果 


eono 1. bash 


node timeouts. js 
1000 
3738 





图 3-1: 程序 显示 了 每 个 setTimeout 执 行 的 时 间 间 隔 ， 其 结果 





3 中 设 定 的 值 并 不 相同 
为 什么 会 这 样 呢 ? 究 其 原因 ， 是 事件 轮 询 MJavaScriptftiBEL ik 了 。 当 第 一 个 事件 分 发 
全 执行 JavaScript 回 滑 a 由 TEMOR 要 执行 很 长 的 一 段 时 间 ( 循环 次 数 很 多 ) 


所 以 下 一 个 事件 轮 询 执行 的 时 间 就 远 远 超 过 了 2 秒 。 因 此 ，JavaScript 的 timeout 并 不 能 严格 遵守 
时 钟 设置 ， 


` 
心 


当然 了 ， 这 样 的 行为 方式 并 不 理想 。 正 如 我 此 前 介绍 的 ， 事 件 轮 询 是 Node IO 的 基础 核 «C 32] 
既然 超时 可 以 延迟 ,， 那 HTTP 请 求 以 及 其 他 形式 的 IO 均 可 如 此 。 也 就 意味 着 ，HTTP 服 务 器 


每 秒 处 理 的 请 求 数量 减少 了 ， 效 率 也 就 降低 了 


1 


正 因 如 此 ， 许 多 优秀 的 Node 模 块 都 是 非 阻 塞 的 ， 执 行 任务 也 都 采用 了 异步 的 方式 。 
既然 执行 时 只 有 一 个 线程 ， 也 就 是 说 ， 当 一 个 函数 执行 时 ， 同 一 时 间 不 可 能 有 第 二 个 函数 


PEATE: Node 早 期 版 本 的 确 不 行 ， 但 是 截止 到 本 书 翻译 期 间 ，Node 0.8.x 和 0.10.x 都 已 经 内 置 了 child_ process 模 块 ， 


允许 创建 子 进程 
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也 在 执行 ， 那 Node.js 又 是 如 何 做 到 高 并 发 的 呢 ? 比如 ， 一 台 普 通 的 笔记 本 电脑 ， 用 Node 书 写 
的 简单 的 服务 器 就 能 够 处 理 每 秒 上 千 个 请 求 。 

为 了 搞 清楚 这 个 问题 ， 你 首先 要 明白 调用 堆栈 的 概念 。 

当 v8 首 次 调用 一 个 函数 时 ， 会 创建 一 个 众所周知 的 调用 堆栈 ， 或 者 称 为 执行 堆栈 。 


如 果 该 函数 调用 又 去 调用 另外 一 个 函数 的 话 ，v8 就 会 把 它 添加 到 调用 堆栈 上 。 考 虑 如 下 例 
Tu 


function a () ( 
b(); 

} 

function b()(); 


针对 上 述 例子 ， 调 用 堆栈 是 “a” 后 面 跟着 “b”。 当 “b” 执 行 完 ，v8 就 不 再 执行 任何 代 
码 了 。 
回 到 HTTP 服 务 器 的 例子 : 


http.createServer(function () { 
a(); 

); 

function a() { 
b(); 

}; 

function b()(); 


在 上 述 例子 中 ,一旦 HTTP 请 求 到 达 服 务 器 ，Node 就 会 分 发 一 个 通知 。 最 终 ， 回 调 函 数 会 
被 执行 ， 并 且 调 用 堆栈 变 为 “a”> "b", 

由 于 Node 是 运行 在 单线 程 环境 中 ， 所 以 ， 当 调用 堆栈 展开 时 ，Node 就 无 法 处 理 其 他 的 客 
户 端 或 者 HTTP 请 求 了 。 


你 也 许 在 想 ， 那 照 这 样 看 来 ，Node 的 最 大 并 发 量 不 就 是 1 了 ! 是 的 。 Node 并 不 提供 真正 
的 并 行 操作 ， 因 为 那样 需要 引入 更 多 的 并 行 执 行 线程 。 


关键 在 于 ， 在 调用 堆栈 执行 非常 快 的 情况 下 ， 同 一 时 刻 你 无 须 处 理 多 个 请 求 。 这 也 是 为 何 
说 v8 搭 配 非 阻塞 IO 是 最 好 的 组 合 : v8 执行 JavaScript 速 度 非 常 快 ， 非 阻塞 1O 确 保 了 单线 程 执行 
时 ,不 会 因为 有 数据 库 访 问 或 者 硬盘 访问 等 操作 而 导致 被 挂 起 。 


一 个 真实 世界 的 运用 非 阻 塞 IO 的 例子 是 云 。 在 绝 大 多 数 如 亚马逊 云 ( “AWS” ) 这 样 的 
云 部 署 系 统 中 ， 操 作 系统 都 是 虚拟 出 来 的 ， 硬 件 也 是 由 租用 者 之 间 互 相 共享 的 (所 以 说 你 是 在 
“ 租 硬 件 ” ) 。 也 就 是 说 ， 假 设 硬盘 正在 为 另外 的 租用 者 搜索 文件 ， 而 你 也 要 进行 文件 搜索 ， 
那么 延迟 就 会 变 长 。 由 于 硬盘 的 IO 效率 是 非常 难 预测 的 ， 所 以 ， 读 文件 时 ， 如 果 把 执行 线程 阻 
塞 住 ， 那么 程序 运行 起 来 也 会 非常 不 稳定 ， 而 且 很 慢 。 


在 我 们 的 应 用 中 ， 常 见 的 10 例 子 就 是 从 数据 库 中 获取 数据 。 假 设 我 们 需要 为 某 个 请 求 响 
应 数据 库 获取 的 数据 


在 上 述 例 子 中 ， 当 请 求 到 达 时 ， 调 用 堆栈 中 只 有 数据 库 调 用 。 由 于 调用 是 非 阻塞 的 ， 当 数 
据 库 IO 完成 时 ， 就 完全 取决 于 事 们 dele 才 再 初始 化 新 的 调用 堆栈 。 不 过 ,在 告诉 Node“ 当 
你 获取 数据 库 响 应 时 记得 通知 我 ”之 后 ，Node 就 可 以 继续 处 理 其 他 事情 了 。 也 就 是 说 ，Node 
可 以 去 处 理 更 多 的 请 求 了 ! 

接 下 来 要 介绍 的 ， 同 时 也 是 本 书 贯 穿 始 终 的 一 个 话题 ， 就 是 错误 处 理 ， 这 个 话题 和 Node 
涤 构 方式 有 着 很 大 的 关系 


首先 ， 很 重要 的 一 点 ， 正 如 本 章 之 前 介绍 的 ，Node 应 用 依托 在 一 个 拥有 大 量 共享 状态 的 
大 进程 中 
举例 来 说 ， 在 一 个 HTTP 请 求 中 ， 如 果 某 个 回调 函数 发 生 了 错误 ， 整 个 进程 都 会 遭 融 : 


tty 


AFR RA AR, AT VilA] Web ak, ERAR, ünpd3-2B ZR 


eoo 1. bash 


* node uncaught-http.js 


/private/tmp/uncaught -http. js:4 
throw new Error('This will be uncaught') 


Error: This will be uncaught 
at Server.«anonymous» (/private/tmp/uncaught-http.js:4: 
9) 
Server.emit (events.js:70:17) 

t HTTPParser . onIncomir: tp. js:1514:12) 
HTTPParser . onHeaders( lete (http.js:102:31) 
Socket.ondata (htt 10:22) 

TCP.onread (net.js:3* 
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Node 之 所 以 这 样 处 理 是 因为 ， 在 发 生 未 被 捕获 的 错误 时 ， 进 程 的 状态 就 不 确定 了 。 之 后 
就 可 能 无 法 正常 工作 了 ,并且 如 果 错 误 始 终 不 处 理 的 话 ， 就 会 一 直 抛 出 意料 之 外 的 错误 ， 这 样 
很 难 调试 。 

如 果 添 加 了 uncatchException 处 理 器 ， 就 不 一 样 了 。 这 个 时 候 ， 进 程 不 会 退出 ， 并 且 
之 后 的 事情 都 在 你 的 掌控 中 。 


process.on('uncaughtException', function (err) { 
console.error(err); 
process.exit(1); // 手动 退出 

)): 


在 上 述 例 子 中 ， 行为 方式 和 分 发 error 事 件 的 API 行 为 方式 一 致 。 比 如 ， 考 虑 如 下 例子 ， 
创建 一 个 TCP 服 务 器 ， 并 用 telnet 工 具 发 起 连接 : 


var net = require('net'); 


net.createServer (function (connection) { 
connection.on('error', function (err) { 
// err 是 一 个 错误 对 象 
hs 
)).listen(400); 


Node 中 ， 许 多 像 http、net 这 样 的 原生 模块 都 会 分 发 error 事 件 。 如 果 该 事件 未 处 理 ， 
就 会 抛 出 未 捕获 的 异常 。 

除了 uncaughtException 和 erzor 事 件 外 ， 绝 大 部 分 Node 异 步 API 接 收 的 回调 函数 ， 第 
一 个 参数 都 是 错误 对 象 或 者 是 nul1: 


[35 > var fs = require('fs'); 


fs.readFile('/etc/passwd', function (err, data) { 
if (err) return console.error (err) ; 
console.log(data); 

)); 


错误 处 理 中 ， 每 一 步 都 很 重要 ， 因 为 它 能 让 你 书写 更 安全 的 程序 ， 并 且 不 丢失 触发 错误 的 
上 下 文 信息 。 


堆栈 追踪 
在 JavaScript 中 ， 当 错误 发 生 时 ， 在 错误 信息 中 可 以 看 到 一 系列 的 函数 调用 ， 这 称 为 堆栈 
追踪 。 看 如 下 例子 : 


function c () { 
b(); 
}; 


f 


^ 


El 


if] 


运行 上 述 代 码 就 能 看 到 堆栈 追踪 信息 ， 如 图 3-3 所 示 


eoo 1. bash 


node error.js 


node. js:201 
throw e; // process.nextTick error, or 'error' even 


t on first tick 


A 


Error: here 
at a (/private/tmp/error.js:10:9) 


b (/priv /tmp/error.j 
c (C/private/tmp/error. js: 

Object.<anonymous> (/priv /tmp/error.js:13:1) 
Module.. compile (module 

Object..js (module ~ 

Module. load (moc y 

Function. load ( js:308:12) 

Array.@ (module. js:479:10) 

EventEmitter ._ 








图 3-3: 针对 上 述 代码 ，V8 显 示 
在 上 图 中 ， 你 能 清晰 地 看 到 导 


ce A 
HEAR: 


XE E 


执行 上 述 代码 时 ( 如 图 3-4 所 示 ) ,堆栈 信息 中 有 价值 的 f 


致 错误 发 生 的 也 数 调用 路 径 


T 


A 


下 面 ， 我 们 来 看 一 下 引入 事件 


息 就 丢失 了 
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eoo 1. bash 


* node tim-error.js 


timers. js:96 
if CIprocess.listeners('uncaughtException').len 


gth) throw e; 


^ 
Error: here 
at Object. onTimeout (/private/tmp/tim-error.js:11:11) 
at Timer.ontimeout (timers.js:94:19) 





同 理 ， 要 捕获 一 个 未 来 才 会 执行 到 的 函数 所 抛 出 的 错误 是 不 可 能 的 。 这 会 直接 抛 出 未 捕获 
的 异常 ， 并 且 catch 代 码 块 永远 都 不 会 被 执行 : 


这 就 是 为 什么 在 Node.js 中 ， 每 步 都 要 正确 进行 错误 处 理 的 原因 了 。 一 旦 和 遗漏， 你 就 会 发 
现 发 生 了 错误 后 很 难 追 踪 ， 因 为 上 下 文 信息 都 丢失 了 


注意 ， 有 一 点 很 重要 ， 将 来 Node 会 让 异步 处 理 器 抛 出 的 异常 更 容易 被 追踪 到 


至 此 ， 你 已 经 明白 了 事件 轮 询 、 非 阻塞 IO 以 及 V8 是 如 何 互相 配合 为 开发 者 提供 书写 高 性 
能 网 络 应 用 的 能 力 

相信 你 还 学 到 了 ，Node 通 过 单线 程 的 执行 环境 ， 提 供 了 极 大 的 简便 ， 不过， 也 正 因 如 
此 ， 当 你 书写 网 络 应 用 时 ， 要 尽 可 能 地 避免 使 用 同步 10。 除 此 之 外 ， 相 信和 你 也 明白 了 ， 该 线程 
中 所 有 的 状态 都 是 维护 在 一 个 内 存 空 间 中 的 ， 换 句 话 说 ， 写 程序 的 时 候 要 格外 小 心 

相信 你 也 清楚 地 看 到 了 ， 非 阻塞 IO 和 回调 引入 了 新 的 调试 和 错误 处 理 的 方式 ， 这 种 方式 
与 写 阻 塞 式 IO 的 程序 时 是 截然 不 同 的 


CHAPTER 


Node 中 的 


JavaScript 





在 Node.js 中 写 JavaScript 和 在 浏览 器 中 写 JavaScript 截 然 不 同 。Node.js 除 了 提供 和 浏览 器 一 
样 的 基本 语言 之 外 ， 还 在 语言 基础 上 提供 了 构建 强大 网 络 应 用 所 需 的 API。 


通过 本 章 的 介绍 ， 你 会 看 到 一 些 API， 这 些 API 是 Node 和 浏览 器 都 有 的 ， 但 却 是 语言 本 身 
之 外 、 不 在 标准 中 定义 的 。 而 更 重要 的 是 ， 如 本 章 标题 — “Node 中 的 JavaScript” 所 暗示 
的 ， 本 章 会 介绍 Node.js 的 核心 扩展 相关 内 容 。 


首先 我 们 来 看 看 global 对 象 的 区 别 。 


global 对 象 


在 浏览 器 中 ， 全 局 对 象 指 的 就 是 window 对 象 。 在 window 对 象 上 定义 的 任何 内 容 都 可 以 
被 全 局 访问 到 。 比 如 ，setTimeout 其 实 就 是 window.setTimeout，document 其 实 就 是 


window.document, 
Node 中 有 两 个 类 似 但 却 各 自 代表 着 不 同 含义 的 对 象 ， 如 下 所 示 。 
a global; 和 window 一 样 ， 任 何 global 对 象 上 的 属性 都 可 以 被 全 局 访问 到 。 
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* process; 所 有 全 局 执行 上 下 文中 的 内 容 都 在 process 对 象 中 。 在 浏览 器 中 ， 只 有 一 
个 window 对 象 ， 在 Node 中 ,也 只 有 一 个 process 对 象 。 举 例 来 说 ， 在 浏览 器 中 窗口 
的 名 字 是 window.name， 类 似 的 ， 在 Node 中 进程 的 名 字 是 process .title。 


下 一 章 内 容 会 深入 介绍 process 对 象 ， 因 为 它 提供 了 丰富 有 趣 的 功能 ， 尤 其 是 对 于 命令 
行程 序 来 说 。 
实用 的 全 局 对 象 

浏览 器 中 有 些 函 数 和 工具 虽然 并 非 语言 标准 的 一 部 分 ， 但 却 非常 实用 ， 如 今 ， 它 们 已 经 被 
人 们 看 作 是 JavaScript 的 一 部 分 了 。 它 们 都 是 以 全 局 的 形式 暴露 出 来 的 。 


举例 来 说 ，setTimeout 并 非 ECMAScript 的 一 部 分 ， 但 浏览 器 却 仍 将 其 视 作 重要 的 特性 
来 实现 。 事 实 上 ， 该 函数 是 无 法 通过 纯 JavaScript 重 写 的 ， 不 信 的 话 你 可 以 去 试 试 。 


另外 有 些 API， 人 们 还 在 讨论 是 否 要 加 入 到 语言 规范 中 ( 处 在 建议 阶段 ) ， 不 过 ，Node. 
js 为 了 让 编写 Node 应 用 效率 更 高 就 把 它们 加 进来 了 。setImmediate API 就 是 一 个 例子 ， 在 
Node 中 ， 它 的 作用 和 process .nextTick 相 当 。 


process .nextTick 函 数 可 以 将 一 个 函数 的 执行 时 间 规划 到 下 一 个 事件 循环 中 : 


console.log(1); 

process.nextTick(function () { 
console.log(3); 

3); 

console.l10og(2); 


把 它 想象 成 是 setTimeout (fn, 1) 或 者 “通过 异步 的 方法 在 最 近 的 将 来 调用 该 函数 ”， 
你 就 很 容易 能 理解 为 什么 上 述 例子 的 输出 结果 是 1.2.3 了 。 

还 有 一 个 类 似 的 例子 是 console，console 最 早 由 Firefox 中 辅助 开发 的 插件 一 一 Firebug 
实现 。 最 后 ，Node 也 引入 了 一 个 全 局 console 对 象 ， 该 对 象 有 一 些 如 console.1og 和 
console .erzor 这 样 的 很 有 用 的 方法 。 


模块 系统 

JavaScript 原 生态 是 一 个 全 局 的 世界 。 所 有 如 setTimeout 、document 等 这 样 在 浏览 器 端 
使 用 的 API， 都 是 全 局 定义 的 。 

当 你 引入 第 三 方 模块 时 ， 最 好 它们 也 暴露 一 个 (或 者 多 个 ) 全 局 变量 。 比 如 ， 当 你 在 
HTMIL 文 档 中 引入 <script src-"http://code. jquery.com/jquery-1.6.0.js"> 
后 ， 你 可 以 通过 该 模块 上 的 jQuery 对 象 来 使 用 : 
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<script> 
jQuery(function () { 
alert('hello world!'); 
334 
«/script» 


之 所 以 这 样 的 根本 原因 是 ，JavaScript 语 言 标准 中 并 未 为 模块 依赖 以 及 模块 独立 定义 专门 
的 API。 因 此 ， 就 导致 了 通过 这 种 方式 引入 的 多 个 模块 会 出 现 对 全 局 命名 空间 的 污染 及 命名 冲 
突 的 问题 。 

Node 内 置 了 很 多 实用 的 模块 作为 基础 的 工具 集 来 帮助 构建 现代 应 用 ,包括 httP、net、 
fs， 等 等 。 此 前 在 第 1 章 “ 安 装 ” 中 也 介绍 过 ， 通 过 NPM 你 可 以 安装 更 多 的 模块 。 

Node 气 弃 了 采用 定义 一 堆 全 局 变量 ( 或 者 跑 很 多 可 能 根本 就 不 会 用 到 的 代码 ) 的 方 
式 ， 转 而 引入 了 一 个 简单 但 却 强大 无 比 的 模块 系统 ， 该 模块 系统 有 三 个 核心 的 全 局 对 象 : 


require, modulefllexports, 


绝对 和 相对 模块 
这 里 ， 绝 对 模块 是 指 Node 通 过 在 其 内 部 node_modules 查 找到 的 模块 ， 或 者 Node 内 置 的 如 
fs 这 样 的 模块 。 


正如 在 第 1 章 中 介绍 的 ， 当 你 安装 好 了 colors 模 块 ， 其 路 径 就 变 成 了 ./node_modules/colors。 
这 个 时 候 ， 你 就 可 以 直接 通过 名 字 来 require 这 个 模块 ， 无 须 添 加 路 径 名 : 


require('colors') 


colors 模 块 修改 了 String.prototype， 因 此 ， 它 无 须 暴 露 API。 而 fs 模块 ， 则 暴露 了 
一 系列 函数 : 


var fs = require('fs'); 

fs.readFile('/some/file', function (err, contents) { 
if (!err) console.log(contents) ; 

)); 


模块 还 可 以 使 用 模块 系统 的 功能 来 提供 更 加 简洁 独立 的 API 以 及 抽象 。 然 而 ， 不 一 定 非 要 
将 模块 或 者 应 用 每 一 个 部 分 都 作为 一 个 单独 的 模块 和 各 自 单独 的 package .json 文 件 ， 你 可 
以 使 用 我 所 说 的 相对 模块 。 


相对 模块 将 require 指 向 一 个 相对 工作 目录 中 的 JavaScript 文 件 。 为 了 证 明 这 一 点 ， 我 们 
在 同一 目录 中 创建 名 为 nodule_a.js、module b.js 以 及 main .js 的 三 个 文件 。 











module_a.js 


console.log('this is a'); 





35 


module_b.js 


main.js 


然后 ， 运 行 main 文 件 ( 见 图 4-1 ) : 


如 图 4-1 所 示 ， 
来 安装 ， 也 不 在 node modules 目 录 中 ， 而 且 Node 自 带 模块 中 没有 以 此 为 名 的 模块 





Node 未 能 找到 module a 和 module b 


1. bash 


r ‘error’ even 


1. bash 





原因 就 在 于 它们 并 没有 通过 NPM 


复 上 述 例子 中 这 个 问题 ， 需 要 在 require 参 数 前 加 上 . /: 


成 功 ! 这 两 个 模块 都 执行 了 。 接 下 来 ， 我 要 介绍 如 何 让 这 些 模块 暴露 API， 从 而 


require 时 ， 可 以 将 其 赋值 给 一 个 变量 


全 局 变量 


在 默认 情况 下 ， 每 个 模块 都 会 暴露 出 一 个 空 对 象 。 如 果 你 想 要 在 该 对 象 上 添加 属性 ， 


简单 地 使 用 exports 即 可 : 


module_a.js 


我 们 来 测试 下 ( 见 图 4-3 ) : 


index.js 


8,0 9 1. bash 


* node index. js 
john 
this is some data 
5 





Ist GAAD 
3K BJAPI 





图 4-3: 查看 modu] 


在 上 述 例子 中 ，exports 其 实 就 是 对 module .exports 的 引用 ， 其 在 默认 情况 下 是 - 
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要 让 模块 暴露 一 个 API 成 为 require 调 用 的 返回 值 ， 就 要 依靠 module 和 exports 这 两 个 


那么 


-个 对 


象 。 要 是 在 该 对 象 上 逐个 添加 属性 无 法 满足 你 的 需求 ， 你 还 可 以 彻底 重 写 module .exports 


下 面 就 是 一 个 常见 的 将 模块 中 构造 器 暴露 出 来 的 例子 ( 见 图 4-4 ) : 


Cu] 





=> 





person. js 
=’ , this.name 
index. js 
8.0.8 1. bash 


node 


index. js 
is john 


my name 











图 4-4: 一 cript OOP 风 格 的 Node.js 模 块 的 例子 

如 上 述 :例子 所 述 ， 在 index 文 件 中 ,你 不 再 是 接收 一 个 对 象 作为 返回 值 ， 而 是 函数 ， 这 得 
归功 于 对 module .exports 的 重 写 

Node.js 中 的 基础 API 之 一 就 是 EventEmitter。 无 论 是 在 Node 中 还 是 在 浏览 器 中 ， 大 量 


Wh 


代码 都 依赖 于 所 监听 或 者 分 发 的 事件 : 


浏览 器 中 负责 处 理事 件 相 关 的 DOM API4 
以 及 dispatchEvent。 它 们 还 用 在 一 


下 述 例 子 发 起 一 个 Ajax 请 求 
据 何 时 到 达 : 


( 现代 浏 览 给 中 ) 





:要 包括 addEventListener、 


并 通过 监听 state 


EventListener 





remov: 


系列 从 window 到 XMLHTTPRequest 等 的 其 他 对 象 上 


Change 事 件 来 获知 数 
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var ajax = new XMLHTTPRequest 


ajax.addEventListener('stateChange', function () { 
if (ajax.readyState == 4 && ajax.responseText) { 
alert('we got some data: ' + ajax.responseText) ; 
} 
1); 
ajax.open('GET', '/my-page'); 


ajax.send(null); 

在 Node 中 ， 你 也 希望 可 以 随处 进行 事件 的 监听 和 分 发 。 为 此 ，Node 暴 露 了 Event EmitterAPI, 
该 API 上 定义 了 人 on、emit 以 及 removeListener 方 法 。 它 以 process .EventEmitter 形 式 
暴露 出 来 : 





eventemitter /index. js 


var EventEmitter = require('events').EventEmitter 
, a = new EventEmitter; 

a.on('event', function () ( 
console.log('event called'); 

)); 

a.emit('event'); 


这 个 API 相 比 DOM 中 的 更 简洁 ，Node 内 部 在 使 用 ， 你 也 可 以 很 容易 地 将 其 添加 到 自己 的 
类 中 : 


var EventEmitter = process.EventEmitter 
, MyClass = function ()(); 


MyClass.prototype._proto__ = EventEmitter.prototype; 


这 样 ， 所 有 MyClass 的 实例 都 具备 了 事件 功能 : 


var a = new MyClass; 

a.on( ‘$£— H/F? , function () ( 
// 做 些 什么 

FFs 


事件 是 Node 非 阻塞 设计 的 重要 体现 。Node 通 常 不 会 直接 返回 数据 ( 因为 这 样 可 能 会 在 等 
待 某 个 资源 的 时 候 发 生 线程 阻塞 ) ， 而 是 采用 分 发 事件 来 传递 数据 的 方式 。 


我 们 再 以 HTTP 服 务 器 为 例 。 当 请 求 到 达 时 ，Node 会 调用 一 个 回调 函数 ， 这 个 时 候 数据 可 
能 不 会 一 下 子 都 到 达 。POST 请 求 (用户 提 交 一 个 表单 ) 就 是 这 样 的 例子 。 


当 用 户 提交 表单 时 ， 你 通常 会 监听 请 求 的 data 和 end 事 件 : 


http.Server(function (req, res) { 
var buf = '' 
req.on('data', function (data) { 
buf += data; 
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}); 
req.on('end', function () { 
console. log ( “数据 接收 完毕 !“”) ; 
); 
); 


这 是 Node.js 中 很 常见 的 例子 : 将 请 求 数据 内 容 进行 缓冲 ( data 事件 ) ， 等 到 所 有 数据 都 接 
收 完毕 后 (end 事件 ) 再 对 数据 进行 处 理 。 


不 管 是 否 “所 有 的 数据 ”都 已 到 达 ，Node 为 了 让 你 能 够 尽快 知道 请 求 已 经 到 达 服 务 器 ， 
都 需要 分 发 事件 出 来 。 在 Node 中 ， 事 件 机 制 就 是 一 个 很 好 的 机 制 ， 能 够 通知 你 尚未 发 生 但 即 
将 要 发 生 的 事情 。 


事件 是 否 会 触发 取决 于 实现 它 的 API。 比 如 ， 你 知道 了 ServerReaquest 继 承 自 EventEmitter， 
现在 你 也 知道 了 它 会 分 发 data 和 end 事 件 。 


有 些 API 会 分 发 error 事 件 ， 该 事件 也 许 根本 不 会 发 生 。 有 些 事件 只 会 触发 一 次 ( 如 end 事 
TE) ， 而 有 些 则 会 触发 多 次 (如 data 事 件 ) 。 有 些 API 只 会 在 特定 情况 下 触发 某 种 事件 。 又 比 
如 ， 在 特定 的 事件 发 生 后 ， 某 些 事件 就 不 再 触发 。 在 上 述 HTTP 的 例子 中 ， 你 肯定 不 希望 在 end 
事件 触发 后 还 触发 data 事 件 ， 和 否则， 你 的 应 用 就 会 发 生 故 障 了 。 

同样 的 ， 有 的 时 候 ， 会 有 这 样 的 需求 : 不管 某 个 事件 在 将 来 会 被 触发 多 少 次 ， 我 都 希望 只 
调用 一 次 回调 函数 。Node 为 这 类 需求 提供 了 一 个 名 字 简 洁 的 方法 : 

a.once(' 某 个 事件 ' function () ( 

// 尽管 事件 会 触发 多 次 ， 但 此 方法 只 会 执行 一 次 

)); 

通常 ， 要 和 弄 明 白 哪些 事件 是 可 用 的 ， 以 及 它们 的 “联系 方式 ”( 即 触发 它们 的 条 件 ) , ws 
要 查看 模块 的 API 文 档 。 本 书 中 会 介绍 核心 Node 模 块 的 API 以 及 一 些 重要 的 事件 ， 不 过 ， 带 上 
API 手 册 会 是 个 不 错 的 习惯 ， 帮 助 也 会 很 大 。 


buffer 
除了 模块 之 外 ，Node 还 弥补 了 语言 另外 一 个 不 足 之 处 ， 那 就 是 对 二 进 制 数据 的 处 理 。 


buffer 是 一 个 表示 固定 内 存 分 配 的 全 局 对 象 (也 就 是 说 ， 要 放 到 缓冲 区 中 的 字 节 数 需要 提 
前 定 下 ) ， 它 就 好 比 是 一 个 由 八 位 字 节 元 素 组 成 的 数组 ， 可 以 有 效 地 在 JavaScript 中 表示 二 进 
制 数 据 。 


该 功能 一 部 分 作用 就 是 可 以 对 数据 进行 编码 转换 。 比 如 ， 你 可 以 创建 一 幅 用 base64 表 示 的 
图 片 ， 然 后 将 其 作为 二 进 制 PNG 图 片 的 形式 写 入 到 文件 中 : 
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buffers/index.is 


var mybuffer = new Buffer('--iilj2i3hli23h', 'base64'): 
console.log (mybuffer); 
require('fs').writeFile('logo.png', mybufffer); 








base64 主 要 是 一 种 仅 用 ASCII 字 符 书 写 二 进 制 数据 的 方式 。 换 句 话 说， 它 可 以 让 你 用 简单 
的 英文 字符 来 表示 像 图 片 这 样 的 复杂 事物 (所 以 会 占用 更 多 的 硬盘 空间 ) 。 


在 Nodejs 中 ， 绝 大 部 分 进行 数据 IO 操作 的 API 都 用 buffer 来 接收 和 返回 数据 。 在 上 述 例子 中 ， 
filesystem 模 块 中 的 writeFile API 就 接收 buffer 作 为 参数 ， 并 将 其 写 到 logo .gif 文件 中 。 
运行 该 代码 ， 并 打开 gif 图 片 ( 见 图 4-5 ) : 


$ node index 


$ open logo.png 





图 4-5: 上 述 肢 本 中 ， 从 用 base64 表 示 的 buffer 中 创建 的 GIF 图 片 显 示 了 Node.js 的 logo 

如 上 图 所 示 ， 对 于 要 调用 console . 1og 方 法 输出 buffer 对 象 而 言 ，wziteFile 的 确 是 个 
简单 的 接口 ， 让 原生 字 节 数据 生成 图 片 。 
小 结 

通过 本 章 ， 你 应 该 了 解 到 了 在 浏览 器 端 和 Node.js 中 书写 JavaScript 的 主要 区 别 。 


你 还 应 该 了 解 了 Node 添 加 的 但 在 语言 标准 中 没有 的 JavaScript 中 的 常用 API， 如 定时 器 、 事 
件 、 二 进 制 数据 以 及 模块 。 


你 也 应 该 知道 了 Node 中 也 有 类 似 window 的 对 象 ， 也 可 以 使 用 如 console 这 样 的 开发 者 工 
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本 章 将 介绍 使 用 Node.js 中 一 些 重量 级 API: 处 理 进程 (stdio ) 的 stdin 以 及 stdout 相 
关 的 API， 还 有 那些 与 文件 系统 (£s ) 相关 的 API. 


第 4 章 中 我 们 介绍 过 ，Node 通 过 使 用 回调 和 事件 机 制 来 实现 并 发 。 这 些 API 会 让 你 首次 接 
触 到 基于 非 阻塞 事件 的 MO 编程 中 的 流 控制 。 


除了 介绍 如 何 使 用 这 些 API 之 外 ， 你 还 可 以 通过 本 章 来 构建 首 个 应 用 : 一 个 简单 的 命令 行 
文件 浏览 器 ， 其 功能 是 允许 用 户 读 取 和 创建 文件 。 


我 们 从 定义 需求 开始 : 

= 程序 需要 在 命令 行 运行 。 这 就 意味 着 程序 要 么 通过 node 命 令 来 执行 ， 要么 直接 执 
行 ， 然 后 通过 终端 提供 交互 给 用 户 进行 输入 、 输 出 。 

" 程序 启动 后 ， 需 要 显示 当前 目录 下 列表 ( 见 图 5-1 ) 。 

" 选择 某 个 文件 时 ， 程 序 需要 显示 该 文件 内 容 。 


" 选择 一 个 目录 时 ， 程 序 需要 显示 该 目录 下 的 信息 
。 运行 结束 后 程序 退出 


eoo 2. node 
* node index.js 


to see 


Select which file or directory you want 





根据 上 述 需求 ， 你 可 以 将 此 项 目 细 分 到 如 下 几 个 步骤 : 


创建 模块 
决定 采用 同步 的 fs 还 是 异步 的 fs 
理解 什么 是 流 ( Stream ) 


实现 输入 输出 


重 构 
使 用 fs 进行 文件 交 F. 
完成 
现在 我 们 开始 基于 上 述 步骤 来 编写 一 个 模块 。 模 块 由 几 个 文件 组 成 ， 编 写 时 可 以 使 用 任意 


E Hr 


文本 编辑 器 


通过 本 章 ， 我 们 会 完 有 具备 完整 功能 的 纯 Node.js 应 用 





和 本 书 其 他 例子 一 样 ， 我 们 从 创建 一 个 项 目 目 录 开 始 。 按 照 此 项 目的 需求 ， 我 们 将 该 目录 
命名 为 file-explorer。 

下 如 其 他 章节 所 述 ， 在 项 目 中 定义 package .json 文 件 始终 是 最 佳 实践 。 这 样 ， 既 可 以 
方便 地 对 NPM 中 注册 的 模块 依赖 进行 管理 ， 将 来 也 能 对 模块 进行 发 布 

尽管 此 项 目 仅仅 用 到 Node.js 的 核心 模块 API ( 因此 ,不 会 从 NPM 仓 库 中 获取 模块 ) ,但 


是 ， 我 们 还 是 需要 创建 一 个 简单 的 package . json 文 件 : 





— 


要 验证 你 的 package .json 文 件 是 否 有 效 ， 可 以 运行 $ npm install 


要 是 没有 问题 ， 就 不 会 有 任何 输出 内 容 ， 否 则 会 抛 出 JSON 异 常 的 错误 ( 见 图 5-2 ) 
AOA 2. bash 


s npm install 
Couldn't read dependencies. 


Failed to parse json 
Unexpected token ' 
File: /private/tmp/file-explorer/step-1/package. js 


Failed to parse package.json data. 
package.json must be actual JSON, not j 
JavaScript. 
This is not a bug in npm. 
npm Tell the package author to fix their pa 





ckage.json file. 


图 5-2: packag n 文 件 中 有 JSON 错 误 的 情况 下 运行 npm install 命 令 


接着 ， 我 们 要 创建 一 个 简单 的 包含 程序 完整 功能 的 JavaScript 文 件 : index.js 
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我 们 从 声明 依赖 关系 开始 。 由 于 stdio API 是 全 局 process 对 象 的 一 部 分 ， 所以， 我们 的 
程序 唯一 的 依赖 就 是 fs 模块 ; 


我 们 首先 要 做 的 就 是 获取 当前 目录 的 文件 列表 


| 译 者 注 : http://semver.org 


有 件 重要 的 事情 要 记 住 
说 ， 


它 会 立刻 返回 内 容 或 者 当 有 错误 发 生 时 抛 出 相应 异常 


要 想 获取 当前 目录 的 文件 列表 ， 


fs 模块 是 唯 


1. node 


> console.log(require(' fs').readdirSync(' .')); 
'package.json', 


[ 'index.js', 


>I 


F 面 


E B 
AEFT 


步 的 版 本 : 
如 图 5-4 所 示 ， 
AQAA 


s node 
> function async (err, 


> require('fs').reoddirSync('.", 


图 5-4; 


异步 版 本 的 re 


要 在 单线 程 中 创建 能 够 处 理 高 并 发 的 高 效 程序 ， 


第 3 章 中 提 过 ， 
的 程序 
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~ 


J A - Yr. A LAA 
尽管 本 章 中 这 个 命令 


但 是 ， 为 了 学 习 Nodejs 呈 


为 了 获取 文件 列表 ， 


WR ( 如 果 没 有 错误 发 


上 述 两 


‘test’ ] 


- 样 的 


个 例子 结果 是 一 


1. node 


files) { console.log(files); 


async) 


} 


一 个 同时 提供 同步 和 异 
可 以 使 用 如 下 方式 : 





举 个 例 


步 API 的 模块 ， 


( 见 图 5$-3 ) 





就 得 采用 异步 、 事 件 台 


子 来 


X aJ 


行程 序 并 非 此 类 型 程序 ( 因为 同一 时 间 只 会 有 一 个 人 在 读 取 文 件 ) 
! 最 重要 也 是 最 具 挑 战 的 部 分 ,我 们 还 是 保持 这 种 异步 的 代码 风格 

我 们 需要 使 用 fs .readdir。 我 们 提供 的 回调 函数 首 个 参数 是 一 个 错 
生 ， 该 对 象 为 null ) ， 另 外 一 个 参数 是 一 个 files 数 组 : 


运行 上 述 代码 ， 会 得 到 如 图 $-5 所 示 的 结果 


* node index.js 
[ 'index.js', 'packoge.json', ' 
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好 了 ,至 此 ， 你 已 经 知道 了 fs 模块 同时 提供 了 同步 和 异步 的 API 来 操作 文件 系统 ， 接 下 来 





你 需要 学 习 Node.js 中 一 个 基础 概念 流 
我 们 已 经 知道 ，console .1og 会 输出 到 控制 台 。 事 


实 上 ，console.1og 内 部 做 了 这 样 
的 事情 : 它 在 指定 的 字符 串 后 加 上 \n (换行 ) 字符 ， 并 将 其 写 到 stdout 流 中 
观察 图 5-6 中 显示 的 两 个 程序 的 不 同 点 


809 1. bash 


* node example-1.js 
Hello world 

s node example-2.js 
Hello world + |j 





1-6 - 


我 们 再 来 看 下 面 的 源 代码 : 


和 : 


process 全 局 对 象 中 包含 了 三 个 流 对 象 ， 分 别 对 应 三 个 UNIX 标 准 流 : 


图 5-7 描 述 了 这 三 个 流 对 象 
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Text terminal 





Keyboard 


图 5-7: 传统 文本 终端 下 的 stdio、stdout 以 及 stderr 对 象 
第 一 个 stdin 是 一 个 可 读 流 ， 而 stdout 和 stderr 都 是 可 写 流 。 


stdin 流 默认 的 状态 是 暂停 的 (paused ) 。 通 常 ， 执 行 一 个 程序 ， 程 序 会 做 一 些 处 理 ， 
然后 退出 。 不 过 ， 有 些 时 候 ， 就 像 本 章 中 的 这 个 应 用 一 样 ， 程 序 需要 一 直 处 在 运行 状态 来 接收 
用 户 输入 的 数据 。 


当 恢复 那个 流 时 ，Node 会 观察 对 应 的 文件 描述 符 (在 UNIX 下 为 0) ， 随 后 保持 事件 循环 
的 运行 ， 同 时 保持 程序 不 退出 ， 等 待 事件 的 触发 。 除 非 有 IO 等 待 ， 和 否则 Node.js 总 是 会 自动 退 
出 。 

流 的 另外 一 个 属性 是 它 默 认 的 编码 。 如 果 在 流 上 设置 了 编码 ， 那 么 会 得 到 编码 后 的 字符 串 
( utf-8、ascii 等 ) 而 不 是 原始 的 Buffer 作 为 事件 参数 。 


Steam 对 象 和 EventEmitter 很 像 (事实 上 ， 前 者 继承 自 后 者 ) 。 在 Node 中 ， 你 会 接触 
到 各 种 类 型 流 ， 如 TCP 套 接 字 、HTTP 请 求 等 。 简 而 言 之 ， 当 涉及 持续 不 断 地 对 数据 进行 读 写 
时 ， 流 就 出 现 了 。 


输入 和 输出 
既然 已 经 知道 运行 程序 后 大 概 是 怎样 的 一 个 情形 了 ， 我 们 来 尝试 写 第 一 部 分 ， 列 出 当前 目 
录 下 的 文件 ， 然 后 等 待 用 户 输入 : 


# index.js 
LP s 
fs.readdir(process.cwd(), function (err, files) ( 


console.log(''); 
if (!files.length) ( 
return console.log(' \033 [31m No files to show! V033[39mMn') ; 


) 


console.log(' Select which file or directory you want to see\n'); 
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function file(i) { 


var filename = files[il]; 


fs.stat(  dirname + '/' + filename, function (err, stat) { 


if (stat.isDirectory()) { 

console.log(' ‘+it+' \033[36m' + filename + '/\033[39m'); 
} else { 

console.log(' ‘+it+' \033[90m' + filename + '\033[39m'); 
} 
i++; 
if (i == files.length) { 


console.log(''); 
process.stdout.write(' \033[33mEnter your choice: \033[39m'); 


process.stdin.resume() ; 


~ 


else { 
file(i); 
} 
X 
) 


file(0); 
); 


下 面 ， 我 们 来 逐 行 分 析 上 述 代码 。 
为 了 输出 更 加 友好 ， 我 们 首先 输出 一 个 空 行 : 


console.log('') 


如 果 files 数 组 为 空 ， 告 知 用 户 当 前 目录 没有 文件 。 文 本 周围 的 \033 [31m 和 \033 [39m 是 
为 了 让 文本 呈现 为 红色 。 例 子 中 最 后 一 个 字符 又 是 换行 符 \n， 也 是 为 了 输出 更 友好 。 


if (!files.length) { 
return console.log(' \033 [31m No files to show!V033[39mMn') ; 


) 
下 一 行 很 简单 ， 一 眼 就 看 明白 了 : 
console.log(' Select which file or directory you want to see\n'); 


紧 接着 ,定义 了 一 个 函数 ， 数 组 中 每 个 元 素 都 会 执行 该 函数 。 这 里 也 出 现 了 贯穿 本 书 始终 
的 第 一 种 异步 流 控制 模式 : 串 行 执行 。 本 章 最 后 会 对 此 做 详细 介绍 。 


function file (i) { 
T4. sos 
) 


然后 ， 先 获取 文件 名 ， 再 查看 文件 名 对 应 路 径 的 情况 。fs . stat 会 给 出 文件 或 者 目录 的 


5] 


回调 函数 中 ， 同 时 还 给 出 了 错误 对 象 (如果 有 的 话 ) 和 一 个 Stat 对 象 。 本 例 中 所 使 用 到 


的 Stat 对 象 上 的 方法 是 isDirectory: 


如 果 路 径 所 代表 的 是 目录 ， 我 们 就 用 有 别 于 文件 的 颜色 标识 出 来 
接 下 来 就 到 了 流 控制 中 的 核心 部 分 了 。 计 数 器 不 断 递增 ,与 此 同时 ， 检查 是 否 还 有 未 处 理 
的 文件 : 
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如 果 所 有 文件 都 处 理 完毕 ， 此 时 提示 用 户 进行 选择 。 注 意 ， 这 里 使 用 的 是 process . stdqonut . 
write 而 不 是 console.1og; 这 样 就 无 须 换行 ， 让 用 户 可 以 直接 在 提示 语 后 进行 输入 ( 见 图 5-8 ) 





15-8. 程序 所 FAR [s]st yt 4 T$ ^ 


下 面 这 行 代码 ， 此 前 介绍 过 ， 是 用 户 等 待 用 户 输入 : 
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紧 跟 着 这 行 代码 的 是 设置 流 编码 为 utfg ， 这 样 就 能 支持 特殊 字符 了 : 

process.stdin.setEncoding('utf8'); 

要 是 还 有 未 处 理 的 文件 ， 则 递归 调用 该 函数 来 进行 处 理 : 

file(i); 

直到 列 出 所 有 文件 、 用 户 输入 完毕 后 ， 紧 接着 进行 下 一 步 串 行 处 理 。 这 是 本 音 介 绍 的 首 个 
重要 的 模式 。 


重 构 
要 做 重 构 ， 我 们 从 为 几 个 常用 的 变量 ( 如 stdin 和 stqout ) 创建 快捷 变量 开始 : 
# index.js 


PA aw s 
var fs - require('fs') 
, stdin = process.stdin 


, Stdout - process.stdout 


由 于 我 们 书写 的 代码 都 是 异步 的 ， 因 此 ， 会 有 这 样 的 问题 : 随 着 函数 量 的 增长 〈 特别 是 流 
控制 层 的 增加 ) ， 过 多 的 函数 租 套 会 让 程序 的 可 读 性 变 差 。 


为 了 避免 此 类 问题 我们 可 以 为 每 一 个 异步 操作 预先 定义 一 个 函数 。 
首先 ， 我 们 抽 离 出 一 个 读 取 stdin 函 数 : 


# index.js 
// called for each file walked in the directory 
function file(i) { 


var filename = files[i]; 


fs.stat(_ dirname + '/' + filename, function (err, stat) { 
if (stat.isDirectory()) { 
console.log(' '+i+' \033[36m' + filename + '/\033[39m'); 
} else { 
console.log(' '+i+' \033{90m' + filename + '\033[39m'); 
} 


if (++i == files.length) ( 
read(); 
} else { 
file(i); 
} 
J); 
} 


// read user input when files are shown 
function read () { 
console.log(''); 
stdout.write(' \033[33mEnter your choice: X033[39m'); 


注意 ， 上 述 代码 所 使 用 的 是 新 的 stdain 和 stdout 引 用 


读 取 用 上 户 输 ji A , 下 来 要 做 的 就 是 -根据 用 户 输入 做 出 相应 处 理 用 户 需要 选择 
就 开始 监听 其 aata 事 件 : 


文件 ， 所 以 ， 面 ， 我 们 设置 了 stdin 的 编码 后 ， 





这 里 ， 我 们 检查 用 | 了 译 否 匹配 files 数 组 : 


回调 函数 中 的 一 部 分 吧 RA. 要 注意 的 是 ， 
data 转 化 为 Number 类 型 来 方便 做 检查 


如 果 检 查 通 ii pul ， 我 们 要 确保 从 将 流 TH f ( 
Ja, RE E a 


eo 1. node 
s node index.js 


Select which file or directory you want to see 


至 此 ， 我 们 的 程序 已 经 能 够 与 用 户 进行 交互 了 ， 


面 我 们 来 实现 读 取 和 显示 文件 内 容 


[n] Bl) Bh 


将 





IZ 


MB 


PÉI FER 
上 述 代码 中 ， 


还 记得 files 数 组 是 fs .readdiz 


我 们 将 utf-8 编 码 的 字符 串 类 型 


\ 认 状态 ) ， 以 便于 之 后 做 完 Es 操 作 


寺中 的 文件 列表 展现 给 用 户 ， 下 


既然 都 能 定位 到 文件 了 ， 那 是 时 候 去 读 取 它 了 ! 


再 次 提醒 ， 我 们 可 以 事先 指定 编码 ， 这 样 我 们 得 到 的 数据 就 是 相应 的 字符 串 了 : 


接着 ， 可 以 使 用 正则 表达 式 添加 一 些 辅助 缩 进 后 将 文件 内 容 进行 输出 〈 见 图 $-10 ) : 


eoo 1l. bash 
* node index.js 


Select which file or directory you want to see 


Enter your choice: 1 





图 5-10:， 读 取 简 单 文件 的 例子 
不 过 ， 要 是 选择 的 是 目录 呢 ? 这 种 情况 下 ， 我 们 就 应 当 将 其 目录 下 的 文件 列表 显示 出 来 。 


为 了 避免 再 次 执行 fs . stat， 我 们 在 Eile 函 数 中 ,将 Stat 对 象 保存 下 来 : 
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eT, MER WPM Eopt ion kk HUET REAVER St T£S .readFile 


的 代码 位 置 : 


现在 再 运行 该 程序 ， 就 能 够 进行 目录 选择 ， 并 能 看 到 该 目录 下 的 文件 列表 信息 了 ( 见 图 5-11 ) 


eoe 1. bash 


node index. js 


Select which file or dir 


完成 ! EMRE IE Nodef 


完成 了 首 个 命令 行程 序 之 后 ， 有 必 


很 AR i ; HJ] 





> 行 (CLI) 


` 要 学 习 一 些 API， 它 们 对 于 书写 在 终端 运行 的 类 似 程序 


process .argv 包 含 了 所 有 Node 程 序 运行 时 的 参数 值 : 


如 图 5-12 所 示 ， 第 一 个 元 素 始终 是 node 、 第 二 个 元 素 始终 是 执行 的 文件 路 径 。 紧 接着 是 


命令 行 后 紧 跟 着 的 参数 


a 09 1. bash 


* node example 
[ 'node', '/private/tmp/file-explorer/argv/example' ] 





图 5 一 1 内 容 的 例子 


要 获取 这 些 真正 的 元 素 ， 需 要 首先 将 数组 的 前 两 个 元 素 去 除 掉 ( 见 图 5-13) : 


OOA 1. bash 
* node example-2 --testing="something” --yeah 
[ '--testingssomething', '--yeadh' ] 








接 下 来 ， 你 需要 学 会 如 何 获取 两 个 不 同 的 目录 : 一 个 是 程序 本 身 所 在 的 目录 ， 另 外 一 个 是 
程序 运行 时 的 目录 


在 此 前 的 例子 中 ， 我 们 使 用 dirname 来 获取 执行 文件 时 该 文件 在 文件 系统 中 所 在 的 
目录 

不 过 ， 有 的 时 候 ， 更 希望 获得 程序 运行 时 的 当前 工作 目录 。 以 此 前 例子 而 言 ， 如 果 在 
home 目 录 下 运行 该 程序 ， 获 得 的 ses HCE SA DH TETEN, Al A index.js 
文件 的 路 径 始 终 没 变 ， 因 此 ”dirname 也 不 会 变 


要 获取 当前 工作 目录 ， 可 以 调用 process .cwd 方 法 : 








[65 > 


Node 还 提供 了 process .chdir 方 法 ， 人 允许 灵活 地 更 改 工 作 目 录 : 


还 有 另外 一 个 和 程序 运行 上 下 文 有 关 的 方面 就 是 环境 变量 。 


请 接着 往 下 看 。 


Node 人 允许 通过 process .env 变 量 来 轻松 访问 shell 环 境 下 的 变量 。 


运行 在 开发 模式 下 还 是 产品 模式 下 


时 ， 


eoo 1. node 


$ NODE ENVe"production" node 
> process.env.NODE_ENV 


> process.env. SHELL 


>I 





T ， ep ee 
图 5-14:， NODE ENV 环 境 变量 


了 涤 此 之 外 ， 在 程序 中 控制 程序 自身 的 退出 也 是 很 有 必要 的 。 


sea s ih H, ms .exit 并 提供 一 
要 退出 程序 ， 这 个 时 候 最 好 是 使 用 退出 代码 1: 


个 退出 代码 。 比 如 ， 


这 样 可 以 让 Node 命 令 行 程序 和 操作 系统 中 其 他 工具 进行 更 好 的 协同 。 


男 外 还 有 一 点 就 是 进程 信号 


进程 和 操作 系统 进行 通信 的 其 中 一 种 方式 就 是 通过 信号 。 比 如 ， 要 让 进程 终止， 


SIGKILL 信 号 。 


Node 程 序 是 通过 在 Process 对 象 上 以 事件 分 发 的 形式 来 发 送 


a 言 号 zu. 


量 用 来 控制 程序 是 


举例 来 说 ， 一 个 最 常见 的 环境 变量 就 是 NODE_ENV ( 见 图 5$-14 ) , RES 


当 发 生 错误 


可 以 发 送 
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process.on('SIGKILL', function () { 
// 信号 已 收 到 
)); 


接 下 来 我 们 看 看 此 前 的 程序 是 如 何 使 用 转 义 码 让 终端 文本 呈现 不 同 颜色 的 。 


ANSI 转 义 码 
要 在 文本 终端 下 控制 格式 、 颜 色 以 及 其 他 输出 选项 ， 可 以 使 用 ANSI 转 义 码 。 
在 文本 周围 添加 的 明显 不 用 于 输出 的 字符 ， 称 为 非 打 印字 符 。 
比如 ， 看 下 面 这 个 例子 : 
console.log('\033[90m' + data.replace(/(.*)/g, ' $1') + '\033[39m'); 
= \033 表 示 转 义 序 列 的 开始 。 
" [表示 开始 颜色 设置 。 
= 90 表 示 前 景色 为 亮 灰色 。 
= nm 表示 颜色 设置 结束 。 
或 许 你 已 经 注意 到 了 ， 最 后 用 的 是 39， 没 错 ， 这 是 用 来 将 颜色 再 设置 回去 的 ， 我 们 这 里 
只 想 对 部 分 文本 着 色 。 
http://en.wikipedia.org/wiki/ansi_escape_code 列 出 了 一 张 完 整 的 ANSI 转 义 码 表 。 


对 fs 一 探究 竟 

fs 模块 允许 你 通过 Stream API 来 对 数据 进行 读 写 操作 。 与 readFile 及 writeFile 方 法 不 
同 ， 它 对 内 存 的 分 配 不 是 一 次 完成 的 。 

比如 ， 考 虑 这 样 一 个 例子 ， 有 一 个 大 文件 ,文件 内 容 由 上 百 万 行 逗号 分 割 文本 组 成 。 要 完 
整地 读 取 该 文件 来 进行 解析 ， 意 味 着 要 一 次 性 分 配 很 大 的 内 存 。 更 好 的 方式 应 当 是 一 次 只 读 取 
一 块 内 容 ， 以 行 尾 结束 符 ("\n" ) 来 切 分 ， 然 后 再 逐 块 进行 解析 。 


下 面 要 介绍 的 Node Stream 就 是 对 上 述 解决 方案 完美 的 实现 。 
Stream — 

fs .createReadStream 方 法 允许 为 一 个 文件 创建 一 个 可 读 的 Stream 对 象 。 

为 了 更 好 地 理解 stream 的 威力 ， 我 们 来 看 如 下 两 个 例子 。 


fs.readFile('my-file.txt', function (err, contents) { 
11 对 文件 进行 处 理 
ns 
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上 述 例子 中 ， 回 调 函 数 必须 要 等 到 整个 文件 读 取 完 毕 、 载 和 人 到 RAM、 可 用 的 情况 下 才 会 
触发 。 
而 下 面 这 个 例子 ， 每 次 会 读 取 可 变 大 小 的 内 容 块 ， 并 且 每 次 读 取 后 会 触发 回调 函数 : 
var stream = fs.createReadStream('my-file.txt'); 
stream.on('data', function(chunk) { 
11 处 理 文件 部 分 内 容 


10; 
stream.on('end', function(chunk) { 


/7 文件 读 取 完毕 
)); 
为 什么 这 种 能 力 很 重要 呢 ? 假设 有 个 很 大 的 视频 文件 需要 上 传 到 某 个 Web 服 务 。 这 时 ， 你 
无 须 在 读 取 完 整 的 视频 内 容 后 再 开始 上 传 ， 使 用 Stream 就 可 以 大 大 提速 上 传 过 程 。 


这 对 日 志 记 录 的 例子 也 很 有 效 ， 特 别 是 使 用 可 写 stream。 假 设 有 个 应 用 需要 记录 网 站 上 的 
访问 情况 ， 这 时 ， 为 了 将 记录 写 到 文件 中 ， 让 操作 系统 进行 打开 /关闭 文件 的 操作 可 能 就 很 低 
AK. (每 次 都 得 要 在 磁盘 上 进行 查找 文件 操作 ) 。 


所 以 ， 这 就 是 一 个 很 好 的 使 用 fs .WriteStream 的 例子 。 打 开 文件 操作 只 做 一 次 ， 然 后 
写 人 每 个 日 志 项 时 都 调用 . write 方法 。 


另外 一 个 很 好 的 符合 Node 非 阻塞 设计 的 例子 就 是 监视 ( Watch ) 。 


监视 
Node 人 允许 监视 文件 或 目录 是 否 发 生变 化 。 监 视 意 味 着 当 文 件 系 统 中 的 文件 (或 者 目录 ) 
发 生变 化 时 ， 会 分 发 一 个 事件 ， 然 后 触发 指定 的 回调 函数 。 


该 功能 在 Node 生 态 系统 中 被 广泛 使 用 。 举 例 来 说 ， 有 人 喜欢 用 一 种 可 以 编译 为 CSS 的 语言 
来 书写 CSS 样 式 。 这 个 时 候 ， 就 可 以 使 用 监视 功能 ， 当 源 文 件 发 生 改变 时 ， 就 将 其 编译 为 CSS 
文件 。 


我 们 来 看 下 面 这 个 例子 。 首 先 ， 查 找 工作 目录 下 所 有 的 CSS 文 件 ， 然 后 监视 其 是 否 发 生 改 
变 。 一 旦 文件 发 生 更 改 ， 就 将 该 文件 名 输出 到 控制 台 : 


' var stream = fs.createReadStream('my-file.txt'); 

var fs - require('fs'); 
// 获取 工作 目录 下 所 有 的 文件 
var files = fs.readdirSync(process.cwd()); 
files.forEach(function (file) { 

77 VEO “less” ARASH 

if (/\.css/.test(file)) { 

fs.watchFile(process.cwd() + '/' + file, function () { 


console.log(' - ' + file + ' changed!'); 


CHAPTER 5 。 命令 行 工具 (CLI) 以 及 FS API: 首 个 Node 应 用 


Hs 
) 
3); 


除了 fs .watchEile 之 外 ， 还 可 以 使 用 fs . watch 来 监视 整个 目录 。 


小 结 

本 章 介绍 了 书写 Node.js 程 序 的 基础 知识 ， 特 别 是 如 何 书写 一 个 与 文件 系统 进行 交互 的 命 
令 行 程序 。 

尽管 用 同步 的 fs API 来 完成 本 章 首 个 示例 程序 也 没有 什么 不 妥 ， 但 本 章 着 重 是 要 介绍 如 何 
使 用 异步 AP 来 帮助 大 家 掌握 书写 包含 多 层 回 调 的 复杂 代码 的 方法 。 不 管 怎么 样 ， 我 们 还 是 成 
功 地 完成 了 一 个 包含 完整 功能 、 代 码 整 洁 的 应 用 。 

本 章 还 介绍 了 Node 中 最 为 重要 的 API 之 一 一 一 Stream，Stream 会 在 本 书 中 频繁 出 现 。 几 
乎 所 有 涉及 到 IO 的 地 方 都 有 它 的 身影 ，Stream 真 的 非常 棒 。 

除 此 之 外 ， 本 章 还 教会 了 你 使 用 工具 来 创建 有 用 的 命令 行程 序 ， 与 文件 系统 、 其 他 程序 进 
行 交 互 ， 以 及 获取 用 户 的 输入 。 

作为 Node.js 开 发 者 ， 不 论 是 写 Web 应 用 还 是 写 更 加 复杂 的 应 用 ， 这 些 API 会 经 常 使 用 到 
( 特别 是 process 对 象 上 的 API ) 。 好 好 地 记 住 这 些 API! 
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CHAPTER 


TCP 





传输 控制 协议 (TCP) 是 一 个 面向 连接 的 协议 ， 它 保证 了 两 台 计 算 机 之 间 数 据 传输 的 可 靠 
性 和 顺序 。 

换 名 话说 ，TCP 是 一 种 传输 层 协 议 ， 它 可 以 让 你 将 数据 从 一 台 计 算 机 完整 有 序 地 传输 到 另 
一 台 计 算 机 。 

正 是 由 于 这 些 特点 ， 很 多 我 们 现在 使 用 的 如 HTTP 这 样 的 协议 都 是 基于 TCP 协 议 的 。 当 传 
输 一 个 页 面 的 HTML 文 件 时 ， 肯 定 是 希望 它 传输 到 目的 地 时 能 够 与 传输 前 一 致 ， 要 是 出 什么 问 
题 ， 就 应 该 抛 出 错误 。 哪 怕 有 一 个 字符 ( 字 节 传输 错位 了 ， 浏 览 器 都 有 可 能 无 法 泻 染 这 个 页 
面 。 

Node.js 这 个 框架 的 出 发 点 就 是 为 了 网 络 应 用 开发 所 设计 的 。 如 今 ， 网 络 应 用 都 是 用 TCP/ 
IP 协 议 进 行 通信 的 。 所 以 ， 了 人 解 TCP/IP 协 议 是 如 何 工 作 的 ， 以 及 Node.js 是 如 何 通 过 简单 的 API 
对 其 进行 封装 的 ， 都 是 非常 有 帮助 的 。 

首先 要 介绍 的 是 该 协议 的 特点 。 举 例 来 说 ， 使 用 TCP 在 两 台电 脑 之 间 进 行 数据 传输 是 如 何 
做 到 的 。 当 传输 两 条 消息 时 ， 传 输 到 目的 地 时 还 能 保持 发 送 前 的 顺序 吗 ? 理解 协议 本 身 对 于 理 
解 使 用 该 协议 的 软件 也 是 很 重要 的 。 比 如 ， 大 部 分 时 候 ， 连 接 如 MySQL 等 的 数据 库 以 及 与 数 
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据 库 进行 通信 使 用 的 都 是 TCP 套 接 字 。 


Node HTTP 服 务 器 是 构建 于 Node TCP 服 务 器 之 上 的 。 从 编程 角度 来 说 ， 也 就 是 Node 中 的 
http.Server 继 承 自 net .Server ( net 是 TCP 模 块 ) 。 


除了 Web 浏 览 器 和 服务 器 (HTTP) 之 外 ， 很 多 我 们 日 常 使 用 的 如 邮件 客户 端 ( SMTP/ 
IMAP/POP ) 、 聊 天 程序 (IRC/XMPP ) 以 及 远程 shell ( SSH) 等 都 基于 TCP 协 议 。 


尽 可 能 多 地 了 解 TCP 以 及 如 何 使 用 相关 的 Node.js API 对 书写 和 理解 网 络 程序 会 大 有 神 益 。 


TCP 有 哪些 特性 
若 只 是 使 用 TCP 的 话 ， 那 无 须 理解 它 内 部 的 工作 原理 ， 以 及 其 实现 机 制 。 


不 过 ， 理 解 这 些 东西 对 分 析 更 高 层 的 协议 和 服务 器 ， 如 Web 服 务 器 、 数 据 库 等 的 问题 有 很 
大 的 帮助 。 


TCP 的 首要 特性 就 是 它 是 面向 连接 的 。 
面向 连接 的 通信 和 保证 顺序 的 传递 


说 到 TCP， 可 以 将 客户 端 和 服务 器 端的 通信 看 作 是 一 个 连接 或 者 数据 流 。 这 对 开发 面向 服 
务 的 应 用 和 流 应 用 是 很 好 的 抽象 ， 因 为 TCP 协 议 做 基于 的 卫 协 议 是 面向 无 连接 的 。 


耳 是 基于 数据 报 的 传输 。 这 些 数据 报 是 独立 进行 传输 的 ， 送 达 的 顺序 也 是 无 序 的 。 
那么 TCP 又 是 如 何 保证 这 些 独 立 的 数据 报 送 达 的 时 候 是 有 序 的 呢 ? 


使 用 下 协 议 意 味 着 数据 包 送 达 时 是 无 序 的 ， 这 些 数据 包 不 属于 任何 的 数据 流 或 者 连接 ,， 那 
么 当 使 用 TCP/IP 和 服务 器 建立 连接 后 ， 是 怎样 做 到 让 数据 包 送 达 时 是 有 序 的 呢 ? 


要 回答 上 述 问题 其 实 就 等 于 在 解释 为 什么 会 有 TCP。 当 在 TCP 连 接 内 进行 数据 传递 时 ， 发 
送 的 IP 数 据 报 包含 了 标识 该 连接 以 及 数据 流 顺序 的 信息 。 


假设 一 条 消息 分 割 为 四 个 部 分 。 当 服务 器 从 连接 A 收 到 第 一 部 分 和 第 四 部 分 后 ， 它 就 知道 
还 要 等 待 其 他 数据 报 中 的 第 二 部 分 和 第 三 部 分 。 


要 是 用 Node 来 写 一 个 TCP 服 务 器 ， 就 完全 没 必要 去 考虑 这 些 复杂 的 内 部 实现 了 。 只 要 考虑 
连接 以 及 往 套 接 字 中 写 数 据 即 可 。 接 收 方 会 按 序 接收 到 传输 的 信息 ， 要 是 发 生 网 络 错 误 ， 连 接 
会 失效 或 者 终止 。 


CHAPTER 6 * TCP 


面向 字 节 

TCP 对 字符 以 及 字符 编码 是 完全 无 知 的 。 正 如 第 4 章 介 绍 的 ， 不 同 的 编码 会 导致 传输 的 字 
节 数 不 同 。 

所 以 ，TCP 人 允许 数据 以 ASCII 字 符 ( 每 个 字符 一 个 字 节 ) 或 者 Unicode ( 即 每 个 字符 四 个 
字 节 ) 进行 传输 。 

正 是 因为 对 消息 格式 没有 严格 的 约束 ,使 得 TCP 有 很 好 的 灵活 性 。 





可 靠 性 
由 于 TCP 是 基于 底层 不 可 靠 的 服务 ， 因 此 ， 它 必须 要 基于 确认 和 超时 实现 一 系列 的 机 制 来 
达到 可 靠 性 的 要 求 。 
当 数 据 发 送出 去 后 ， 发 送 方 就 会 等 待 一 个 确认 消息 (表示 数据 包 已 经 收 到 的 简短 的 确认 消 
息 ) 。 如 果 过 了 指定 的 窗口 时 间 ， 还 未 收 到 确认 消息 ， 发 送 方 就 会 对 数据 进行 重 发 。 
这 种 机 制 有 效 地 解决 了 如 网 络 错误 或 者 网 络 阻塞 这 样 的 不 可 预测 的 情况 。 
流 控制 
要 是 两 台 互 相通 信 的 计算 机 中 ， 有 一 台 速 度 远 快 于 另 一 台 的 话 ， 会 怎么 样 呢 ? 
TCP 会 通过 一 种 叫 流 控制 的 方式 来 确保 两 点 之 间 传 输 数 据 的 平衡 。 


拥堵 控制 
TCP 有 一 种 内 置 的 机 制 能 够 控制 数据 包 的 延迟 率 及 丢 包 率 不 会 太 高 ， 以 此 来 确保 服务 的 质 
量 ( QoS ) o 


举例 来 说 ， 和 流 控制 机 制 能 够 避免 发 送 方 压 垮 接收 方 一 样 ，TCP 会 通过 控制 数据 包 的 传输 
速率 来 避免 拥堵 的 情况 。 


好 了 ， 介 绍 完 TCP 的 基本 工作 原理 ， 到 实践 的 时 候 了 。 为 了 测试 TCP 服 务 器 ， 我 们 可 以 使 
用 Telnet 工 具 。 





Telnet 
Telnet 是 一 个 早期 的 网 络 协议 ， 旨 在 提供 双向 的 虚拟 终端 。 在 SSH 出 现 前 ， 它 作为 一 种 控制 
远程 计算 机 的 方式 被 广泛 使 用 ， 如 远程 服务 器 管理 。 它 是 TCP 协 议 上 层 的 协议 ( 不 要 惊讶 ) 。 
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尽管 iat 纪 初 就 基本 不 用 Telnet 了 ， 但 如 今 绝 大 部 分 主流 的 操作 系统 都 内 置 了 telnet 
客户 端 ( 见 图 6-1 ) 


绝 大 部 分 Telnet 使 用 的 是 23 号 端口 。 要 是 通过 该 端口 连接 到 服务 右 (telnet host.com 23 
或 者 就 简单 地 写成 telnet host.com) ， 就 说 明 在 通过 TCP 使 用 Telnet 协 议 


ena 1. telnet 





不 过 ， 在 本 例 中 ， telnet F NOE RE RUITR NUS RUXING 发 送 数据 时 ， 客 户 端 要 是 发 现 
服务 器 使 用 的 并 不 是 Telnet， 这 时 ， 它 不 会 关闭 连接 或 者 显示 错误 信息 ， 相 反 ， 它 会 自动 降级 
到 低层 的 纯 TCP 模 式 

所 以 ， 要 是 telnet 到 Web 服 务 器 会 怎么 样 呢 ? 要 一 探究 竟 ， 我 们 来 看 下 面 这 个 例子 


首先 ， 我 们 用 Node.js 来 写 一 个 简单 的 hello world Web 服 务 器 ， 并 监听 3000 端 口 : 


下 来 通过 node server .js 运行 上 述 代码 。 要 确保 运行 正常 ， 可 以 打开 一 个 典型 的 
HTTP 客 户 端 浏览 器 来 查看 ， 如 图 6-2 所 示 





eoo http: //localhost:3000/ 


© localhost:3000 


Hello world 





现在 来 实现 客户 端 部 分 。 使 用 kelnet 来 建立 一 个 连接 ( 见 图 6-3 ) 


s telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 


Escape character is '^]'. 





尽管 根据 图 6-3 中 所 示 的 结果 ,看 上 去 已 经 工作 正常 了 ,， (A, HEAR AWA "Hello 
World” 消 息 并 未 到 客户 端 这 里 。 原 因 在 于 ， 要 往 TCP 连 接 中 写 数 据 ， 必 须 首 先 创建 一 个 HTTP 
请 求 ， 这 就 是 套 接 字 (socket) 。 在 终端 输入 GET /HTTP/1.1 然 后 按 两 下 回 车 刍 


如 图 6-4 所 示 ， 这 个 时 候 ， 服 务 器 端的 啊 应 就 出 现 了 ! 


e 1. telnet 
* telnet 127.0.0.1 3000 

Trying 127.0.0.1... 

Connected to localhost. 

Escape character is '^]'. 

GET / HTTP/1.1 


HTTP/1.1 2080 OK 
Content-Type: text/html 


Connection: keep-alive 
Transfer-Encoding: chunked 


14 
<hi>Hello world</hi> 
0 





我 们 来 总 结 

" 成 功 建立 了 一 个 TCP 连 接 

" 创建 了 一 个 HTTP 请 求 

” 接收 到 了 一 个 HTTP 啊 应 

= 测试 了 一 些 TCP 的 特性 。 到 达 的 数据 和 在 Node.js 中 写 的 一 样 : 先 写 了 Content-Type 
响应 头 ， 然 后 是 响应 体 ， 最 后 所 有 的 信息 都 按 序 到 达 
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基于 TCP 的 聊天 程序 
正如 此 前 介绍 的 ，TCP 的 主要 目的 就 是 为 两 台 计算 机 通过 提供 可 靠 的 网 络 进行 通信 。 


本 音 选 择 一 个 聊天 应 用 作为 TCP 的 “Hello World” 程 序 ， 因 为 ， 它 是 展示 TCP 最 简单 的 方 


式 之 一 。 
下 面 ， 我 们 来 创建 一 个 基本 的 TCP 服 务 器 ， 任 何人 都 可 以 连接 到 该 服务 器 ， 无 须 实 现任 何 
协议 或 者 指令 : 


" 成 功 连接 到 服务 器 后 ， 服 务 器 会 显示 欢迎 信息 ， 并 要 求 输入 用 户 名 。 同 时 还 会 告诉 你 
当前 还 有 多 少 其 他 客户 端 也 连接 到 了 该 服务 器 。 

" 输入 用 户 名 ， 按 下 回 车 键 后 ， 就 认为 成 功 连接 上 了 。 

" 连接 后 ， 就 可 以 通过 输入 信息 再 按 下 回 车 键 ， 来 向 其 他 客户 端 进行 消息 的 收发 。 


为 什么 要 按 下 回 车 键 呢 ? 事实 上 ，Telnet 中 输入 的 任何 信息 都 会 立刻 发 送 到 服务 器 。 按 下 
回 车 键 是 为 了 输入 \n 字 符 。 在 Node 服 务 器 端 ， 通 过 \n 来 判断 消息 是 否 已 完全 到 达 。 所 以 ， 这 
其 实 是 作为 一 个 分 隔 符 在 使 用 。 


换 句 话说， 这 里 按 下 回 车 键 和 输入 字符 a 没 有 什么 区 别 。 


创建 模块 
按照 惯例 ， 我 们 先 来 创建 一 个 项 目 目录 和 package .json 文 件 : 


# package.json 
{ 
"name": "tcp-chat" 
, “description": "Our first TCP server" 
i "version": "0.0.1" 
) 


接着 运行 npm instal1 测 试 一 下 。 结 果 会 输出 一 个 空 行 ， 因 为 项 目 没有 任何 依赖 。 


理解 NET.SERVER API 
接 下 来 ,创建 一 个 包含 如 下 代码 的 ijndex .js 文件 : 





/** 
* 模块 依赖 
*4 


var net - require('net') 
s 
* 创建 服务 器 
*/ 


注意 ， 上 述 代码 中 为 createServez 指 定 了 一 个 回调 函数 。 该 函数 在 每 次 有 新 的 连接 建 
立时 都 会 被 执行 

为 了 验证 ， 我 们 来 运行 上 述 代 码 ， 启 动 一 个 TCP 服 务 器 。 当 1isten 执 行 时 ， 它 会 将 服务 
器 绑 定 到 3000 端 口 ， 并 最 终 在 终端 打印 出 一 段 消息 


eoo 1. node 


$ node index.js 
server listening on * 





在 图 6-6 中 ， 能 看 到 该 命令 ， 而 且 ，“new connection! ”消息 也 会 显示 出 来 


如 你 所 见 ， 这 个 例子 和 此 前 HTTP 的 hello world 程 序 类 似 。 现 在 再 去 理解 “HTTP 是 建立 在 
TCP 协 议 之 上 的 ”就 不 难 了 吧 。 不 过 ， 本 例 中 ， 我 们 会 创建 自己 的 协议 


createServer 回 调 清 数 会 接收 一 个 对 象 ， 该 对 象 是 Node 中 一 个 很 常见 的 实例 流 
(Stream) 。 本 例 中 ， 它 传递 的 是 net .Stream， 该 对 象 通常 是 既 可 读 又 可 写 的 


最 后 ， 还 有 一 个 重要 的 方法 就 是 1isten， 它 可 以 将 服务 器 绑 定 要 某 个 端口 上 。 由 于 该 方 
法 也 是 异步 的 ， 所 以 也 接收 一 个 回调 函数 。 





eoo 1. node 


s node index.js 
server listening on *:3000 


下 如 此 前 项 目 描述 中 的 ,一旦 连接 建立 ， 


我 们 先 在 回调 函数 外 部 添加 一 个 计数 器 : 





就 会 回 客 户 端 回 写 欢迎 语 和 当前 连接 数 


接 春 ， 我 们 需要 修改 回调 函数 内 容 ， 把 计数 器 递增 和 打印 出 欢迎 语 的 逻辑 添加 上 去 : 


如 上 述 代 码 所 示 ， 我 们 仍旧 使 用 shell 转 义 码 来 控制 输出 文本 的 颜色 


接着 重启 服务 器 进行 测试 : 


再 次 通过 telnet 去 连接 ( 见 图 6-7 ) : 


AQA l. bash em] 


s telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 


> welcome to nod vat! 
> 0 other people are connected at this time. 
> please write your name and press enter: a 





EG. 


MIA 6-8hta, “BoA Peta, eee oT! 


A O 1. telnet 


* telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 


» welcome to no it! 


> 1 other people are connected at this time. 
> please write your name and press enter: | 





26-8. 连接 计数 器 正确 反映 前 连接 数 


当 客 户 端 请 求 关 闭 连 接 时 ， 计 数 器 变量 就 要 进行 递减 操作 : 


当 底 层 套 接 字 关 闭 时 ，Node.js 会 触发 close 事 件 。Node.js 中 有 两 个 和 连接 终止 相关 的 事 


lt. end 和 close。 前 者 是 当 客 户 端 显示 关闭 TCP 连 接 时 触发 。 比 如 ， 当 你 关闭 telnet 时 ， 它 会 
发 送 一 个 名 为 “FIN” 的 包 给 服务 器 ， 意 味 着 要 结束 连接 
当 连 接 发 生 错误 时 (触发 errzor 事 件 ) ，end 事 件 不 会 触发 ， 因 为 服务 器 端 并 未 收 到 


“FIN” 包 信息 。 不 过 这 两 种 情况 下 ，c1lose 事 件 都 会 被 触发 ， 所 以 ， 上 述 例子 中 使 用 close 事 
件 会 比较 好 


在 Mac 上 ， 可 以 通过 按 下 Alt + [来 结束 一 个 telnet 连 接 ，Windows 上 可 以 用 Ctrl + ] 


我 们 已 经 能 在 客户 端 打印 出 一 些 信息 了 ， 接 着 我 们 来 看 看 如 何 处 理 客 户 端 发 送 的 数据 


首先 要 处 理 的 数据 是 用 户 输 入 的 昵称 (nickname) ， 所 以 ， 我 们 从 监听 data 事 件 开 始 。 与 


其 他 Node 中 的 API 一 样 ，net .Stream 同 时 也 是 一 个 EventEmitter 


^ SPE MIN, RIERS d 端的 控制 台 输 出 客户 端 发 来 的 数据 : 


然后 ， 我 们 局 动 该 服务 需 ， HA 户 端 进行 连接 。 如 图 6-9 所 示 ， 在 客户 端 输入 一 些 数 
据 。 看 左 侧 部 分 ， 当 输入 数据 时 ， 服 务 器 端 就 直接 通过 console.1og 将 其 打印 出 来 了 


eoo 1, telnet 


* telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
| Escape character is '^]'. 


| » welcome to ! 

> 0 other people are connected a 
t this time. 

> please write your name and pre 
ss enter: hi 

hi 

hil 





上 部 分 显示 了 右 侧 发 送 过 来 数据 相对 应 的 Buffer 对 象 
如 图 6-9 中 所 示 ， 我 们 接收 到 的 数据 是 一 个 Buffer。 还 记得 此 前 介绍 的 ，TCP 是 面向 字 节 的 
协议 吗 ? 这 里 可 以 看 得 出 来 Node 遵 循 了 TCP 的 这 一 习惯 | 





这 个 时 候 ， ed 选择 可 以 获取 字符 串 形式 的 数据 。 可 以 通过 调用 Buffer 对 象 上 
HJ. toString ('utf8') 来 获取 utf8 编 码 的 字符 串 


不 过 ， 由 于 我 们 这 里 无 须 获取 utf8 之 外 其 他 编码 格式 的 数据 ,我 们 可 以 通过 net. 
Stream#setEncoding 方 法 来 设置 编码 ( 如 图 6-10 所 示 ) 


8.0.90. 1. telnet 
| ¢ telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 


> welcome to node-chat! 
> 0 other people are connected a 
t this time. 


» please write your name and pre 
| ss enter: hi 
| 
jut 


smashing node! 





图 6-10: 聊天 信息 现在 以 utf8 编 码 的 字符 串 形式 输出 在 左 侧 


ET., 至此， 我 们 已 经 可 以 让 客户 端 和 服务 器 进行 交互 了 ， 接 下 来 我 们 要 让 更 多 的 客户 端 
加 入 聊天 


此 前 定义 的 计数 器 通常 称 为 状态 。 因 为 ， 在 本 例 中 ， 两 个 不 同 连接 的 用 户 需 要 修改 同一 个 
状态 变量 ， 这 在 Node 中 称 为 共享 状态 的 并 发 

为 了 能 够 向 其 他 连接 进来 的 客户 端 发 送 和 广播 消息 ， 我 们 需要 对 该 状态 进行 扩展 ， 来 追踪 
到 底 谁 连接 进来 了 

当 客 户 端 输入 了 昵称 后 ， 就 认为 该 客户 端 已 经 连接 成 功 ， 并 可 以 接收 消息 了 

首先 ， 我 们 要 记录 设置 了 昵称 的 用 户 。 为 此 ， 我 们 需要 引入 一 个 新 的 状态 变量 ，users 








在 每 个 连接 中 ， 再 引入 一 个 nickname 变 量 ， 


pr 
表 当 前 连接 的 昵称 


接收 到 数据 时 ， 确 保 将 \z\n ( 相当 于 按 下 回 车 键 ) 清除 : 


Bil EZ Tir] Zac 4 
MS AS H ^1 








[8 > 


ua AT ee 


对 于 尚未 注册 的 用 户 ， 需 要 进行 校 验 。 如 果 昵 称 可用， 则 通知 其 他 客户 端 当 前 用 


接 进 来 了 ( 见 图 6-11 ) : 


$ telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 


» welcome to node-chat! 

» 1 other people are connected at this time. 

» please write your name and press enter; test 
> nickname already in use. try again: woot 





到 RLA EF 
"IO His 


如 果 是 已 经 验证 通过 的 用 户 ， BAR PREIS RUA EAA, th 


其 他 客户 端 : 


= HH EI 
] x MV. 


RE 


-LA 
TN 25 


Hi != nickname 来 确保 消息 只 发 送 给 除了 自己 以 外 的 其 他 客户 端 


图 6-12 展 示 了 两 台 客 户 端 连 接 进 来 之 后 ， 互 相 聊 天 的 场景 


Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 


> welcome to node-chat! 
> 0 other people are connected at this time. 
> please write your name and press enter: test 


> woot: relaying this 
hi 





IHH 


RIK 卯 天 消息 后 ， 我 们 来 圆满 完成 这 个 程序 


当 有 人 上 断 开 连接 时 ， 我 们 需要 清除 users 数 组 中 对 应 的 元 素 : 


目 户 断 开 时 通知 其 他 用 户 也 是 个 不 错 的 想法 。 由 于 我 们 时 不 时 就 需要 给 所 有 的 用 户 广播 消 
开 以 ， 把 这 部 分 逻辑 抽象 出 来 也 不 错 








这 样 一 来 ， 就 可 以 重用 上 面 的 函数 进行 消息 广播 了 ， 人 简洁 易 懂 ， 


我 们 把 它 加 到 close 处 理 器 中 ( 见 图 6-13 ) 


e o 1. telnet 


Connected to localhost. 
Escape character is '^]'. 


> welcome to node zt! 
> 0 other people are connected at this time, 
> please write your name and press enter: test 


> woot: relaying this 





完成 ! 


4k 


在 成 功 实现 r ^^ TC P 服 务 务 Awa Y 我 们 ] 需 要 进 “EF 


LU 


客户 端 API 和 其 他 像 Twitter 这 样 用 来 查询 Web 服 务 的 HTTP 窜 户 六 
些 非常 重要 


ff 


学 习 在 Node.js 中 如 何 实 现 


类 似 ， 


因此 ， 完 


-个 TCP 客 户 端 


全 明白 这 


D 
个 |F 


IRC 是 因特网 中 继 聊 天 (Internet Relay Chat) 的 缩写 ， 它 也 是 一 项 常用 的 基于 TCP 的 协 
议 。 它 通常 被 使 用 在 如 图 6-14 所 示 的 客户 端 程序 中 ， 作 为 连接 到 IRC 服 务 器 的 客户 端 


aoe freenode IRC Network 一 pnodejs (898 Users 
node.js -- WE ARE JAVASCRIPT POWER. 





此 前 我 们 成 功 地 构建 了 一 个 TCP 服 务 器 ， 这 次 我 们 来 写 一 个 TCP 客 户 端 


构建 一 个 实现 IRC 协 议 的 客户 端 意味 着 ， 需 要 实现 通过 一 组 命令 来 实现 与 IRC 服 务 器 进 和 
“通信 ”， 进 行 数据 的 交换 


比如 ， 要 设置 昵称 ， 客 户 端 可 以 发 送 如 下 指令 : 


IRC 是 一 项 非常 直观 、 简 单 的 协议 。 通 过 一 些 简单 的 命令 就 可 以 和 现 有 的 应 用 以 及 服务 器 
( 如 图 6-14 中 展示 的 ) 进行 通信 


下 面 我 们 就 来 学习 如 何 用 Node.js 书 写 一 个 非常 基本 的 客户 端 ， 实现 加 入 一 个 聊天 室 以 及 
回复 消息 功能 


和 往常 一 样 ， 我 们 先 来 创建 一 个 项 目 目录 ， 并 在 该 目录 下 创建 一 个 package .json 文 件 : 


接着 运行 npm instal1。 因 为 项 目 没有 任何 依赖 的 模块 ， 所 以 控制 台 应 当 会 输出 一 个 空 行 
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PART Il * Node 重 要 的 API 


理解 NET#STREAM API 
filcreateServer—##, net _ API 提供 了 另外 一 个 名 为 connect 的 方法 ， 如 下 所 示 : 


net.connect(port[[, host], callback]]) 
如 果 提 供 了 回调 函数 ， 就 等 于 是 监听 了 该 方法 返回 的 对 象 上 的 connect 事 件 。 


var client = net.connect(3000, 'localhost'); 


client.on('connect', function () {}); 


上 述 代 码 和 下 面 的 代码 是 一 样 的 : 


net.connect (300, 'localhost', function () ()); 


另外 ， 和 此 前 使 用 的 API 类 似 ， 我们 还 可 以 监听 data 和 close 事 件 。 


实现 部 分 IRC 协 议 
我 们 先 来 初始 化 IRC 客 户 端 。 然 后 尝试 去 登录 irc .freenode .net 中 的 #4node .js 频道 ， 














var client = net.connect (6667, 'irc.freenode.net') 
设置 编码 为 utf-8: 


client.setEncoding('utf-8') 


连接 上 服务 器 后 ， 发 送 自己 的 昵称 。 除 此 之 外 ， 还 要 写 上 服务 器 要 求 的 USER 命 令 。 采 用 
类 似 如 下 所 示 的 方式 来 发 送 数据 : 
NICK mynick 


USER mynick 0 * :realname 
JOIN #node.js 


具体 代码 如 下 所 示 : 


client.on('connect, function () { 
client.write('NICK mynick\r\n'); 
client.write('USER mynick 0 * :realname\r\n'); 
client.write('JOIN #node.js\r\n') 

}); 


这 里 要 注意 ， 需 要 在 每 条 命令 后 加 上 \z\n 分 割 符 。 这 和 此 前 在 Telnet 下 按 下 回 车 键 是 一 样 
的 。\r\n 也 是 HTTP 协 议 用 来 区 分 头 信 息 的 分 隔 符 。 


测试 实际 的 IRC 服 务 器 
打开 一 个 IRC 客 户 端 (如 Windows 上 的 mIRC、Linux 上 的 xChat 或 者 Mac 上 的 Colloquy/ 
Linkinus ) ， 并 将 其 指向 : 


CHAPTER 6 * TCP 


irc. freenode.net 


#node.js 
启动 后 ， 观 察 nynick 是 否 连接 上 了 : 


![] (http://£.cl.ly/items/1b3g3ilw120Z2U08213G/Image%202011.11.07%202:31:35%20AM. png) 


小 结 

本 章 介 绍 了 一 个 简单 的 网 络 客 户 端 的 实现 ， 成 功 使 其 与 一 台 并 非 自己 实现 的 TCP 服 务 器 进 
行 通信 。 

作为 习题 ， 你 可 以 尝试 着 去 完成 如 下 部 分 : 监听 data 数 据 并 尝试 解析 接收 到 的 数据 ， 将 其 
他 用 户 发 送 到 #node .js 频道 的 消息 打印 出 来 。 你 还 可 以 进一步 尝试 着 结合 现 有 的 代码 去 实现 
一 个 IRC 机 器 人 ， 来 自动 对 命令 做 出 响应 。 比 如 ， 当 某 人 说 日 期 ( data) 时 (可 以 在 data 事 件 中 
检测 到 ) ， 你 就 可 以 输出 new Date () 的 结果 。 

紧 接 着 在 下 一 章 ， 你 会 学 到 HTTP 这 种 Node.js 因 此 闻名 的 Web 协 议 。 现 在 你 对 TCP 中 数 
据 传递 、 数 据 块 的 构建 已 经 很 清楚 了 ， 那 么 接 下 来 学 习 TCP 上 层 的 HTTP API， 一 定 会 让 你 对 
Node.js 中 的 核心 功能 有 更 加 深入 的 了 解 。 
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CHAPTER 


HTTP 





超 文本 传输 协议 ， 又 称 为 HTTP， 是 一 种 Web 协 议 ， 它 为 Web 注 入 了 很 多 强大 的 功能 ， 正 
如 在 第 6 章 中 介绍 的 ， 它 是 属于 TCP 上 层 的 协议 。 


本 章 会 介绍 如 何 使 用 Node.js 服 务 器 端 和 客户 端的 API。 尽 管 两 者 都 很 容易 上 手 ,但 是 在 构 
建 真正 的 Web 网 站 时 ， 它 们 还 是 存在 着 一 些 不 足 的 。 正 因 如 此 ， 下 面 的 章节 还 会 给 大 家 介绍 如 
何 实现 HTTP 服 务 器 上 层 的 抽象 ， 完 成 可 复 用 的 模块 。 


注意 ， 由 于 我 们 要 编写 的 示例 代码 一 部 分 属于 服务 器 端 ， 所 以 每 次 对 文件 进行 修改 ， 都 需 
要 重启 Node 进 程 来 使 其 生效 。 在 本 章 的 最 后 ， 会 给 大 家 介绍 如 何 使 用 工具 来 简化 这 种 频繁 重 
启 的 操作 。 


下 面 ， 就 让 我 们 从 分 析 HTTP 协 议 开 始 吧 。 


HTTP 结 构 


HTTP 协 议 构 建 在 请 求 和 响应 的 概念 上 ， 对 应 在 Node.js 中 就 是 由 http.ServerRequest 
和 http .ServerResponse 这 两 个 构造 器 构造 出 来 的 对 象 。 


当 用 户 浏览 一 个 网 站 时 ， 用 户 代理 (浏览 器 ) 会 创建 一 个 请 求 ， 该 请 求 通过 TCP 发 送 给 





sb 服务 器 ， 随 后 服务 器 会 给 出 啊 应 
那么 ， 请 求 和 响应 是 什么 样 的 呢 ? 我 们 先 用 Node 创 建 - 


Wiffhttp://localhost:3000: 


接着 ， 建 立 一 个 telnet 连 接 ， 并 发 送 请 求 : 


输入 GET / HTTP/1L.1I 后 ， 按 下 两 次 回 车 键 


如 图 7-1 所 示 ， 响 应 会 立刻 出 现 ! 


s telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 
GET / HTTP/1.1 


HTTP/1.1 200 OK 
Connection: keep-alive 
Transfer-Encoding: chunked 


b 
Hello World 





响应 的 内 容 如 下 所 示 : 


该 啊 应 中 第 一 部 分 是 头 信息 ， 下 面 会 对 头 信 息 做 相关 介绍 


HTTP 协 议和 IRC 一 样 流行 ， 其 目的 是 进行 文档 交换 。 它 在 请 求 和 响应 消息 前 使 用 头 信 息 


-个 Hello World]HTTP HR 4$ $5 , 


jf 


(header ) 来 描述 不 同 的 消息 内 容 
举 个 例子 ，Web 页 面 会 分 发 许多 不 同类 型 的 内 容 : 文本 (text), HTML, XML, JSON, 
PNG 以 及 JPEG 图 片 ， 等 等 


发 送 内 容 的 类 型 (type) 就 是 在 著名 的 Content-Type 头 信息 中 标注 的 

来 看 一 个 实践 中 的 例子 。 还 是 回 到 hello world， 不 过 这 次 我 们 在 里 面 加 点 HTML: 

注意 ，World 这 个 单词 放 在 粗 体 的 标签 内 。 我 们 再 通过 简单 的 TCP 客 户 端 来 看 看 效果 ( 见 
图 7-2 

a 曲 日 1. telnet 


* telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is '^]'. 
GET / HTTP/1.1 


HTTP/1.1 200 OK 
Connection: keep-alive 


Transfer-Encoding: chunked 


12 
Hello «b»World«/b» 
9 





响应 结果 和 预期 的 一 样 : 


不 过 ， 现 在 我 们 再 在 浏览 器 中 试 试 ， 看 看 结果 会 如 何 ( 见 图 7-3 ) 








[91 > 


出 ， 


型， 


eos http 


4 * 127.0.0.1:3000 


Hello «b»World«/b» 


appetat 看 到 富 文本， 


之 所 以 会 这 样 ， 


我 们 没有 把 这 部 分 信息 


也 就 是 普通 文本 类 型 ，3 





//127.0.0.1 


7 


EA 


er VRDUI EA 


这 不 会 将 


如 果 我 们 把 代码 稍 做 修改 ， 加 


s telnet 127.0.0.1 3000 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is ‘A]’ 
GET / HTTP/1.1 


HTTP/1.1 200 OK 
Content-Type: text/html 


Connection: keep-alive 
Transfer-Encoding: chunked 


12 
Hello <b>World</b> 
9 


响应 消息 如 下 所 示 : 


1. telnet 


3000 





a$? 


是 因 épais i 


lA 


A 


人 下 确 的 头 信息 Bas 





f 不 知道 服务 器 发 送 过 来 的 内 容 是 什么 类 
Parigi, 


"d AJHTML3ETH Ye 
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HTTP/1.1 200 OK 


Content-Type: text/html 
Connection: keep-alive 


Transfer-Encoding: chunked 


12 
Hello «b»World«/b» 
0 


注意 ， 这 里 头 信 息 包 含 在 响应 消息 中 。 浏 览 器 会 对 其 进行 解析 C 见 图 7-5 ) ， 这 就 能 够 正 
确 地 泻 染 出 HTML 了 。 


eoe http://127.0.0.1:3000/ gl 
CI 127.0.0. 1 3000 _ 








Hello World 


图 7-5: 现在 浏览 器 将 World 这 个 单词 展示 成 粗 体 了 


注意 ， 尽 管 我 们 只 用 writeHead API 指 定 了 一 个 头 信息 ， 但 是 ，Node 还 是 把 另外 两 个 头 
言 息 一 一 Transfer-Encoding 和 Connection 加 进去 了 。 


Transfer-Encoding 头 信息 的 默认 值 是 chunked， 主 要 的 原因 是 Node 天 生 的 异步 机 
制 ， 这 样 响应 就 可 以 逐步 产生 。 


来 看 下 面 这 个 例子 : 


require('http').createServer(function (req, res) { 
res.writeHead (200) ; 
res.write('Hello'); 
setTimeout (function () { 
res.end('World'); 


), 500); 


)).1isten(3000); 
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注意 ,在 调用 end 前 ,我们 可 以 多 次 调用 write 方法 来 发 送 数据 。 为 了 尽 可 能 快 地 响应 客 
户 端 ,在 首次 调用 write 时 ，Node 就 能 把 所 有 的 响应 头 信息 以 及 第 一 块 数据 (Hello) 发 送 
出 去 。 


随后 ， 在 执行 setTimeout 回 调 函 数 时 ， 又 写 人 了 另外 一 块 数据 。 由 于 这 次 是 使 用 end 而 
不 是 write 方法， 因此 ，Node 会 结束 响应 ， 并 不 再 允许 往 这 次 响应 中 发 送 数据 了 。 


发 送 数据 块 的 方式 在 涉及 文件 系统 的 情况 下 会 非常 高 效 。Web 服 务 器 对 硬盘 上 的 文件 进行 
托管 服务 是 很 常见 的 。 因 为 Node 允 许 以 数据 块 的 形式 往 响 应 中 写 数据 ， 同 时 它 又 允许 以 数据 
块 的 形式 读 取 文件 ， 所 以 我 们 就 可 以 使 用 Readstream 文 件 系统 API 来 实现 。 


下 面 这 个 例子 用 于 读 取 image .png 文 件 ， 并 以 正确 的 Content-Type 头 信息 做 出 响应 : 


require('http').createServer(function (req, res) { 
res.writeHead(200, ( 'Content-Type': 'image/png'); 
var stream - require('fs').createReadStream('image.png'); 
stream.on('data', function (data) { 
res.write(data); 
3; 
stream.on('end', function () ( 
res.end(); 
1): 
)).listen(3000); 


以 一 系列 数据 块 的 形式 来 将 图 片 写 入 到 响应 中 ， 有 如 下 好 处 : 


* 高 效 的 内 存 分 配 。 要 是 对 每 个 请 求 在 写 和 前 都 完全 把 图 片 信 息 读 取 完 (通过 
fs.readFile) ， 在 处 理 大 量 请 求 时 会 消耗 大 量 内 存 。 
= 数据 一 旦 就 绪 就 可 以 立刻 写 信 了 。 
另外 ， 这 里 要 注意 的 是 ， 实 际 上 我 们 做 的 就 是 把 一 个 流 (Stream) (文件 系统 ) 接 
(piping) 到 了 另 一 个 流 上 (一 个 http .ServerResponse 对 象 ) 。 正 如 此 前 介绍 的 ， 流 是 
Node.js 中 非常 重要 的 一 种 抽象 。 流 的 对 接 是 很 常见 的 行为 ， 为 此 ，Node.js 提 供 了 一 个 方法 让 
上 述 例子 代码 变 得 非常 简洁 : 


require('http').createServer(function (req, res) { 
res.writeHead(200, { ‘Content-Type’: 'image/png'); 
require('fs') .createReadStream('image.png') .pipe(res) ; 
}) .listen(3000); 


好 了 ， 现 在 你 应 当 明 白 为 什么 Node 默 认 要 用 chunked 传 输 编 码 了 ， 下 面 我 们 来 看 看 连接 


(connection ) 。 


要 是 比 对 一 下 birnan ion 的 实现 ， 你 可 能 会 注意 到 它们 很 相似 : 都 调用 了 
createServez 方 法 ， 并 且 当 客户 端 连 入 时 都 会 执行 一 个 回调 函数 

不 过 ， 它 们 有 个 本 质 的 区 别 ， 即 回调 函数 中 对 象 的 类 型 。 在 net 服 务 器 中 ， 是 个 连接 
(connection) 对 象 ， 而 在 HTTP 服 务 器 中 ， 则 是 请 求 和 响应 对 象 

之 所 以 会 这 样 ， 原 因 有 两 个 。 其 一 ，HTTP 服 务 器 是 更 高 层 的 API， 提 供 了 控制 和 HTTP 协 
议 相 关 的 一 些 功 能 

比如 ， 当 Web 浏 览 器 请 求 服务 器 时 ， 我 们 来 看 下 请 求 对 象 ( 例子 中 的 req 参 数 ) 中 的 
headers 属 性 ( 见 图 7-6 ) 。 作 为 实验 代码 ， 我 们 就 用 console .1log 将 req.headers 属 性 值 
打印 出 来 : 


eoo 1. node 


ac RE 
TM 
‘cache control" 


'accept-language': ' 
'accept-encoding': ' 
connection: 'keep-alive' 








注意 了 ， 这 里 Node 在 内 部 做 了 很 多 的 事情 。 它 拿 到 浏览 器 发 送 的 数据 后 ， 对 其 进行 分 
析 (解析 ) ， 然 后 构造 了 一 个 JavaScript 对 象 方便 我 们 在 脚本 中 使 用 。 它 甚至 还 将 所 有 的 头 
信息 都 变 成 了 小 写 ， 这 样 我 们 就 无 须 去 记忆 到 底 是 Content-type、Content-Type 还 是 


Content-TYPE J 
s [ri] Wo 浏览 锅 在 访问 站 点 时 不 会 就 只 用 - "TEES 很 多 
主流 的 浏览 锅 为 了 更 快 地 加 载 网 站 内 容 ， 能 向 同一 个 主机 打开 八 个 不 同 的 连接 ， 并 发 送 请 求 


尽管 我 们 可 以 通过 req .connection 获 取 TCP 连 接 对 象 ，Node 为 了 不 让 我 们 担心 到 底 这 
是 请 求 还 是 连接 ， 为 我 们 提供 了 请 求 和 响应 的 抽象 。 因 此 ， 即 使 你 能 通过 req .connection 
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属性 获得 TCP 连 接 对 象 ,但 大 多 情况 下 你 还 是 在 与 请 求 和 响应 的 抽象 打交道 。 


默认 情况 下 ，Node 会 告诉 浏览 器 始终 保持 连接 ， 通 过 它 发 送 更 多 的 请 求 。 这 是 通过 此 前 
我 们 看 到 的 Connection 头 信息 中 的 keep-alive 值 来 通知 浏览 器 的 。 为 了 提高 性 能 ( 因为 浏 
览 器 不 想 浪费 时 间 去 重新 建立 和 关闭 TCP 连 接 ) ,这样 做 通常 都 是 对 的 ， 不过， 我 们 也 可 以 调 
用 writeHead 方 法 ， 传 递 一 个 不 同 的 值 ， 如 Close， 来 将 其 重 写 掉 。 


下 一 个 项 目 ， 我 们 会 使 用 Node HTTP API 来 完成 一 个 切实 的 任务 : 处 理 用 户 提交 的 表单 。 


一 个 简单 的 Web 服 务 器 
通过 本 项 目 ， 你 能 够 学 到 如 何 使 用 此 前 列 出 的 一 些 关键 概念 ， 如 Content-Type 头 信息 。 
你 还 将 学 到 Web 浏 览 器 是 如 何在 表单 提交 时 传递 编码 过 的 数据 的 ， 以 及 如 何 将 它们 解析 为 
JavaScript 中 的 数据 结构 。 
创建 模块 
按照 惯例 ， 我 们 从 创建 一 个 项 目 目录 开始 ， 并 在 该 目录 下 创建 一 个 backage .json 文 件 : 


{ 
"name": "http-form" 
, "description": "An HTTP server that processes forms" 
, "version": "0.0.1" 


) 


接着 运行 npm instal1。 因 为 项 目 没有 任何 依赖 的 模块 ， 所 以 终端 应 该 只 会 打印 出 一 个 
313. 


输出 表单 

此 前 Hello <b>wor1ld</b> 例 子 中 ,我 们 输出 了 一 些 HTML 内 容 。 本 例 中 ， 我 们 要 输出 
一 个 表单 。 在 serverjs 文 件 中 写 人 如 下 内 容 : 

require('http').createServer(function (req, res) ( 


res.writeHead(200, ( 'Content-Type': 'text/html' )); 
res.end([ 


Hy} 


‘<form method="POST" action="/url">' 
, '«hl»My form</hi>' 
'«fieldset»' 


'«label»Personal information</label>' 
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'«p»What is your name?</p>' 
‘<input type="text" name="name">' 
'<p><button>Submit</button></p>' 
, '«/form»' 
].join('')); }).listen(3000); 


注意 ， 为 了 让 HTML 结 构 更 加 清楚 ， 我 把 响应 文本 内 容 写 在 一 个 数组 中 ， 再 用 数组 的 
join 方法 将 其 转 为 字符 串 。 其 他 部 分 和 Hello World 例 子 一 样 。 


还 要 注意 的 是 ，<form> 标 签 中 有 /url 以 及 POST 方 法 。 男 外 ， 供 用户 输入 的 输入 框 还 有 
个 叫 name 的 名 字 。 


下 面 ， 我 们 来 运行 服务 顺 : 
$ node server.js 
然后 ， 通 过 浏览 器 进行 访问 ， 如 图 7-7 所 示 ， 就 能 看 到 表单 了 。 


eoe http://127.0.0.1:3000/ £2 
Ltn) ®© 127.0.0.1:3000 x I8] 

















图 7-7: 泻 染 出 的 表单 页 面 

你 可 以 按 下 回 车 键 试 坛 。 浏 览 器 会 发 出 一 个 新 的 请 求 (包含 了 相应 数据 ) ， 不 过 ， 因 为 现 
在 所 有 的 代码 只 用 于 输出 表单 的 HTML， 所 以 结果 与 图 7-7 看 到 的 应 该 是 一 样 的 ( 见 图 7-8 ) 。 
输入 名 字 后 ， 然 后 单 击 “Submit” ( 提交 ) 按钮 。 


eoe http://127.0.0.1:3000/ 
i |© 127.0.0.1:3000 — — 















图 7-8: 表单 提交 的 例子 
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提交 后 的 结果 是 ，URL 变 了 ， 不 过 响应 结果 还 是 一 样 的 ， 如 图 7-9 所 示 。 









http://127:0.0.1:3000/url 
TFT e da " IUD = TREE 





My form 


图 7-9: 尽管 表单 提交 了 ， 但 Node 还 是 以 同样 的 方式 对 请 求 进行 处 理 ， 这 就 是 结果 还 是 一 样 的 原因 
为 了 让 Node 能 够 对 表单 提交 的 请 求 做 出 正确 的 处 理 ， 我 们 需要 学 习 关 于 检测 请 求 方法 和 
URL 的 相关 内 容 。 


method 和 和 URL 
显然 ， 在 用 户 按 下 回 车 键 ( 提交 表单 ) 后 ， 我 们 得 向 用 户 展 示 些 不 同 的 东西 ， 这 个 时 候 就 
需要 处 理 表单 。 


在 代码 的 最 后 ， 需 要 对 请 求 对 象 上 的 url 属 性 进行 检测 。serverjs 的 代码 如 下 所 示 : 


require('http').createServer(function (req, res) { 
if ('/" == req.url) í 
res.writeHead(200, ( 'Content-Type': 'text/html' }); 
res.end([ 
‘<form method-"POST" action="/url">' 
'«hl»My form</hi>' 
‘<fieldset>' 
'<label>Personal information</label>' 
'«p»What is your name?</p>' 
‘<input type="text" name="name">' 


'<p><button>Submit</button></p>' 


. ‘</form>' 
].join('')); 
) else if ('/url' == req.url) { 
res.writeHead(200, ( 'Content-Type': 'text/html' )); 


res.end('You sent a <em>' + req.method + '«/em» request'); 
) 
}) -listen(3000); 


[98 > 如 果 访 问 / URL， 就 会 看 到 如 图 7-10 所 示 的 页 面 ， 没 有 任何 变化 。 
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hitp://127.0.0.1:3000/ x 
ie | ©@ 127.0.0.1:3000 Beatie: 
js RURENIIO IO pae NE d -一 一 - 





图 7-10: 当 访 问 URL 时 ， 请 求 处 理 器 仍旧 显示 同样 的 HTML 内 容 
要 是 输入 /url， 就 会 看 到 如 图 7-11 所 示 的 页 面 。 因 为 该 URL 匹 配 到 了 req.url 在 else 
if 的 这 种 情况 ， 所 以 获得 了 这 样 的 响应 结果 。 


eoo http://127.0.0.1:3000/url F: 
[a è| | @ 127.0.0.1:3000 
ROTO Tt 





You sent a GET request 





图 7-11: 当 访问 /url 时 ， 随 着 *eq.uz1 值 的 变化 导致 了 不 同 的 响应 结果 

但 是 ， 当 在 表单 中 输入 名 字 并 提交 后 ， 就 会 看 到 如 图 7-12 所 示 的 页 面 。 这 是 因为 浏览 器 会 
通过 <form> 标 签 中 action 属 性 指定 的 HTTP 方 法 将 表单 数据 发 送 过 去 。 于 是 ， 在 本 例 中 req. 
method 值 就 是 POST 了 ， 接 着 就 会 响应 出 如 图 7-12 所 示 的 内 容 了 。 


eoe http://127.0.0.1:3000/url E 
© 127.0.0.1:3000 








You sent a POST request 


图 7-12: API, req.methoafüJjPosT 
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如 你 所 见 ， 我 们 接触 了 请 求 对 象 的 两 个 变量 : URL 和 method。 
Node.js 会 将 主机 名 后 所 有 的 内 容 都 放 在 url 属 性 中 。 假 设 访问 http://myhost.com/ 


url?thististatlongturl, 那么 url 的 值 就 会 是 /url?this+ista+long+turl。 


Web 协 议 HTTP/1.1 (你 也 许 还 记得 第 6 章 中 介绍 的 telnet 的 例子 ) ， 为 请 求 定义 了 以 下 


不 同 的 方法 : 
* GET (RU) 
" POST 
" PUT 
= DELETE 


= PATCH (最 新 的 ) 
定义 这 些 不 同方 法 的 用 意 在 于 可 以 让 HTTP 客 户 端 选择 合适 的 方法 ， 通 过 发 送 请 求 数据 ， 
修改 服务 器 上 的 资源 ， 该 资源 通过 URL 来 指定 。 


数据 
当 发 送 HTML 时 ， 需 要 随 着 响应 体 定义 Content-TYpPe 头 信息 。 


和 响应 消息 一 样 ， 请 求 消息 也 可 以 包含 Ccontent-Type 头 信息 。 为 了 更 有 效 地 处 理 表 
单 ， 这 两 部 分 信息 都 是 不 可 或 缺 的 。 就 像 在 没有 显 式 告知 浏览 器 的 情况 下 ， 浏 览 器 不 知道 
Hello World 到 底 是 HTML 还 是 纯 文本 一 样 ， 我 们 怎样 知道 用 户 发 送 的 用 户 名 是 JSON 格 式 、 
XML 格 式 ， 还 是 纯 文本 格式 呢 ?”server .js 代码 如 下 所 示 : 


require('http').createServer(function (req, res) { 
if ('/' == req.url) { 
res.writeHead(200, { 'Content-Type': 'text/html' )); 
res.end([ 
'«form method-"POST" action="/url">' 

‘<hl>My form</hl1>' 
'«fieldset»' 
'«label»Personal information</label>' 
'«p»What is your name?«/p»' 
‘<input type="text" name="name">' 
'<p><button>Submit</button></p>' 


, ‘'</form>' 
].3ein('')J31 
) else if ('/url' == req.url && 'POST' == req.method) ( 
var body - ''; 


req.on('data', function (chunk) ( 
body += chunk; 
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2); 


req.on('end', function () { 
res.writeHead(200, ( 'Content-Type': 'text/html' )); 
res.end('«p»Content-Type: ' + req.headers['content-type'] + '«/p»' 


+ '«p»Data:«/p»«pre»' + body + '«/pre»'); 
3); 


) 
)).listen(3000); 


上 述 代 码 有 什么 变化 呢 ? 我 们 监听 了 data 和 endq 事 件 。 创 建 了 一 个 boqy 字 符 串 用 来 接收 
数据 块 ， 仅 当 eno 事 件 触发 时 ， 我 们 就 知道 数据 接收 完全 了 。 

之 所 以 可 以 这 样 逐 块 接收 数据 ， 是 因为 Node.js 允 许 在 数据 到 达 服 务 器 时 就 可 以 对 其 进行 
处 理 。 因 为 数据 是 以 不 同 TCP 包 到 达 服 务 器 的 ， 这 和 现实 情况 也 完全 匹配 ， 我 们 先 获取 一 部 分 
数据 ， 然 后 在 某 个 时 刻 再 获取 其 余 的 数据 。 


再 次 提交 表单 ， 响 应 结果 如 图 7-13 所 示 。 
eoo http://127.0.0.1:3000/url. x? 


EIIDEZUT NM iiid 


Content-Type: application/x-www-form-urlencoded 












Data: 











namesCuillermo 


图 7-13: 本 例 中 ， 我 们 将 Content-Type 内 容 以 及 请 求 的 数据 内 容 输 出 在 页 面 上 
举 个 例子 ， 当 使 用 Google 进 行 搜索 时 ，URL 通 常 如 图 7-14 所 示 。 


eoo guillermo - Google Search 
© google.com/search?q=guillermo 
Sib ered accu ET 











MIT TR TATEN 









Search 
| Everything IM - | | 
www. imdb.com/name/nm0868219/ 
Images Guillermo del Toro was born October 9, 1964 in 


by his Catholic grandmother, del Toro developed 





图 7-14: 在 搜索 时 ，URL 中 高 亮 的 部 分 为 q=<search term» 


注意 ， 搜 索 部 分 的 URL 和 表单 内 容 一 样 都 是 经 过 编码 的 。 这 也 解释 了 为 什么 Content- 
Type 为 urlencoded 

这 部 分 URL 片 段 又 被 称 为 查询 字符 串 

Node.js 提 供 了 一 个 称 为 querystring 的 模块 ， 可 以 方便 地 对 这 类 字符 串 进行 解析 ， 
样 ， 我 们 就 可 以 像 处 理 头 信息 一 样 对 其 进行 处 理 。 我 们 来 创建 ni oR 
件 ， 添 加 如 下 内 容 并 运行 ( 见 图 7-15 ) 





102 > eoo 1. bash 
node qs- — js 
{ name: ‘Guillermo’ A 
{ q: 'guillermo rauch 





图 7-15: 调用 parse 函 数 后 的 结果 
如 图 7-15 所 示 ，querystring 模 块 将 一 个 字符 串 解析 成 一 个 对 象 。 这 个 解析 处 理 AM 
Node 解 析 headers 消 息 的 方式 类 似 ，Node 将 HTTP 请 求 数据 中 的 headers 信 息 从 字符 串 解析 成 一 
方便 处 理 的 headers 对 象 


接 下 来 我 们 要 使 用 querystring 模 块 来 获取 提交 表单 的 字段 


现在 我 们 要 解析 发 送 进来 的 数据 并 展示 给 用 户 。 将 server .js 改 为 如 下 形式 。 注 意 了 ， 
这 里 我 们 在 end 事 件 中 ,使 用 querystring HAL SEITEN AR Pa RTT , 然后 从 解析 
生成 的 对 象 中 获取 name 的 值 ， 并 将 其 展示 给 用 户 。 注 意 ， 这 里 的 name 是 指 <inpPut> 标 签 中 的 
name 值 。 我 们 来 看 te tei 
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, '«/form»' 
)sjoini'*Y): 
) else if ('/url' == req.url && 'POST' == req.method) { 
var body - '' 


reg.on('data', function (chunk) { 
body += chunk; 

)); 

req.on('end', function () ( 
res.writeHead(200, ( 'Content-Type': 'text/html' }); 
res.end('«p»Your name is «b»' + qs.parse(body).name + '«/b»«/p»'); 

))5; 

} 
}) .listen(3000); 


接着 打开 浏览 器 访问 ， 看 到 了 吧 ( 见 图 7-16 ) ! 103 


eoo http;//127.0.0.1:3000/url ， 
[ala | [© 127.0.0.1:3000 





图 7-16: name ER fü 


让 程序 更 健壮 
这 里 还 有 一 个 问题 : 要 是 URL 没 有 匹配 到 任何 判断 条 件 ， 怎 么 办 ? 


要 是 我 们 访问 /test URL， 你 会 发 现 服务 器 端 一 直 都 没有 响应 ， 浏 览 器 一 直 都 处 在 挂 起 的 


要 解决 这 个 问题 ,我 们 可 以 在 服务 器 不 知道 如 何 处 理 该 请 求 时 ， 发 送 404 (Not Found) 
状态 码 给 客户 端 。 注 意 在 如 下 server .js 代码 中 ,我 们 添加 了 else 的 逻辑 ， 并 调用 了 
writeHead 写 人 404 状 态 码 。 


var qs = require('querystring'); 
require('http').createServer(function (req, res) { 
if ('/* == fegurri) í 
res.writeHead(200, { 'Content-Type': ‘text/html’ }); 
res.end([ 
‘<form method="POST" action="/url">' 
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‘<hl>My form«/hl»' 

'«fieldset»' 

'«label»Personal information</label>' 
'«p»What is your name?</p>' 

'«input type-"text" name-"name"»' 


'<p><button>Submit</button></p>' 


, '«/form»' 
].3oin('')); 
) else if ('/url' -- req.url && 'POST' -- req.method) ( 
var body - '' 


req.on('data', function (chunk) ( 
body *- chunk; 
}): 
req.on('end', function () { 
res.writeHead(200, { 'Content-Type': 'text/html' )); 
res.end('<p>Your name is «b»' + qgs.parse(body).name + '«/b»«/p»'); 
)); 
else ( 


res.writeHead(404); 
res.end('Not Found'); 


) 
)).listen(3000); 


好 了 ， 现 在 我 们 已 经 完成 了 第 一 个 HTTP Web 服 务 器 了 ! 尽管 代码 不 是 那么 的 整洁 ， 不 过 
不 用 担心 ， 接 下 来 的 章节 中 会 介绍 如 何 更 好 地 书写 更 复杂 的 HTTP 服 务 器 。 


我 们 接 下 来 介绍 和 服务 器 端 API 相 对 的 HTTP 客 户 端 API。 


一 个 Twitter Web Piz 
学 习 如 何 使 用 Node.js 向 其 他 Web 服 务 器 发 送 请 求 是 十 分 重要 的 。 


HTTP 已 经 演变 成 并 非 仅 用 于 交换 最 终 演 染 、 展 示 给 用 户 的 标记 文本 ( 如 HTML ) ， 而 且 
它 还 是 服务 器 在 不 同 网 络 环境 传递 数据 的 一 种 方式 。 同 时 ，JSON 因 其 语法 衍生 自 JavaScrip 线 
性 对 象 ， 也 快速 成 为 了 HTTP 默 认 的 标准 数据 格式 ， 这 也 是 Node.js 在 服务 器 端的 优势 之 一 。 

在 本 例 中 ， 会 介绍 如 何 查询 TwitterAPI， 获 取 JSON 数 据 ， 并 解码 为 一 种 数据 结构 ， 以 方便 
对 其 进行 迭代 后 生成 人 类 可 读 的 形式 。 


按照 惯例 ’ 我 们 先 从 创建 A A 该 i a l | 
] 始 : 


{ 
"name": "tweet-client" 


, "description": "An HTTP tweets client" 
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, "version": "0.0.1* 


) 
发 送 一 个 简单 的 HTTP 请 求 

无 独 有 偶 ， 和 我 们 创建 的 TCP 客 户 端 类 似 ， 我 们 通过 http 模 块 中 的 zequest 静 态 方法 创 
建 一 个 Client 对 象 。 

为 了 让 你 更 加 熟悉 ， 我 们 先 回 到 此 前 典型 的 HTTP 服 务 兢 : 


require('http').createServer(function (req, res) { 
res.writeHead (200) ; 
res.end('Hello World'); 

)).1isten(3000); 


然后 ， 写 一 个 客户 端 来 获取 该 响应 ， 并 将 其 在 控制 台 以 彩色 的 形式 打印 出 来 : 


require('http') .request ({ 
host: *127.0.0.1' 
, port: 3000 
urls t'/^ 
, method: 'GET' 
}, function (res) { 
var body = ''; 
res.setEncoding('utf8'); 
res.on('data', function (chunk) ( 
body += chunk; 


})3 
res.on('end', function () { 
console.log('\n We got: \033[96m' + body + '\033[39m\n'); 


)); 
)).end(); 


上 述 代 码 中 ， 首 先 调 用 了 request 方 法 。 此 方法 用 于 初始 化 一 个 新 的 http.Client Request 
对 象 。 

注意 ， 我 们 收集 信息 块 的 方式 和 此 前 在 服务 器 端 收集 客户 端 消息 块 的 方式 一 样 。 连 接 的 远 
程 服 务 器 会 返回 不 同 的 数据 块 ， 我 们 需要 将 它们 全 部 收集 才能 得 到 完整 的 响应 。 当 然 ， 也 有 可 
能 所 有 的 数据 在 一 个 data 事 件 中 都 到 达 了 ， 不 过 我 们 无 从 得 知 。 

所 以 ， 在 本 例 中 我 们 要 监听 end 事 件 ， 然 后 将 body 数 据 打 印 到 控制 台 。 

除 此 之 外 ， 我 们 还 通过 响应 对 象 上 的 setEncoding 将 编码 设置 为 utf8， 因 为 所 有 要 输出 
到 控制 台 的 都 是 文本 。 你 还 可 以 试 试用 客户 端 下 载 一 个 PNG 图 片 ， 这 个 时 候 用 utf8 来 输出 就 
不 合适 了 。 

下 面 ， 我 们 先 运 行 服务 器 ， 然 后 再 运行 客户 端 ( 见 图 7-17 ) : 


$ node client 


97 


105 


8.0.2 1. bash 


* node client.js 


We got: Hello World 





[| 
图 7-17: 从 Hello World 服 务 器 返回 的 消息 在 客户 端 成 功 获取 后 显示 了 出 来 
106 > 下 面 ， 我 们 介绍 如 何 通过 请 求 发 送 数据 





注意 ， 在 之 前 的 例子 中 ， 调 用 完 reauest 之 后 ， 还 需要 调用 ena 

原因 是 在 创建 完 一 个 请 求 之 后 ， 在 发 送 给 服务 器 前 还 可 以 和 request 对 象 进行 交互 。 
比如 ， 下 面 给 你 展示 的 就 是 这 样 一 个 发 送 数 据 给 服务 器 的 例子 

还 记得 之 前 我 们 在 浏览 器 中 创建 的 表单 吗 ? 这 次 仍旧 创建 该 表单 ， 不 过 不 同 的 是 ， 这 次 创 





ee 户 端 、 使 用 Node， 并且 对 于 <form>， 利 用 第 5 章 学 习 的 知识 stdin 来 处 理 。 
服务 需 端 处 理 表单 : 


客户 端 也 要 做 对 应 的 处 理 。 通 过 使 用 querystring 模 块 的 stringify 方 法 ,可 以 将 一 个 
对 象 转化 为 url 编 码 过 的 数据 : 


ar http 
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十 end 方 法 发 送 的 ， 和 我 们 在 服务 器 端 创建 响应 消息 方式 一 样 
器 端 获 取 数 据 块 的 问题 。 你 知道 ， 
从 输 入 数据 即 可 


由 右 侧 提交 的 通 i 


注意 在 上 述 代 码 中 ， 数 据 是 通 


上 F 述 代码 中 ， 无 须 担心 从 服务 
然后 接着 要 求 用 户 再 次 革 


在 左 侧 ， 服 务 需 端 会 显示 


当 end 事 件 触发 时 ， 就 可 


以 将 完整 的 请 求 数据 打印 出 来 ， 
填 stdin 输 入 的 


图 7-18 一 步 步 展 示 了 具体 操作 


名 字 信 息 


AQA 1. node 
erda s node client.js 


your name: guillermo 


your name; ricardo 


your name: victoria 





A e Eea 4 TR D 4z og su E xz 
NZIATE M [5] 4 - 键 ， 随后 ZATIA A 侧 服务 器 端 显示 出 来 


已 经 了 解 了 几乎 全 部 请 求 API 的 用 法 


K 





图 7-18， 当 右 侧 提 
至 此 ， 


fh 了 如 何 通过 请求 发 送 数 据 了 ， 
面 ， 让 我 们 继 


p 
£x 3-56) an ltr! 


-个 tweets 命 令 ， 该 命令 接受 一 个 搜索 参数 ， 


F 面 来 点 实际 有 用 的 东西 ! 我 们 来 创建 
后 将 最 近 相 关 话 题 的 推 文 展示 出 来 。 
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要 是 你 看 过 Twitter 开 放 的 公共 搜索 API 文 档 ， 你 会 发 现 其 URL 是 这 样 的 : nttp:// 


search.twitter.com/search.json?q=bluetangels, 
搜索 结果 数据 如 下 所 示 ( 注意 ， 这 里 我 把 后 面 的 省 略 了 ) : 


"completed in":0.031, 
"max id":122078461840982016, 
"max id str":"122078461840982016", 
"next page":"?page-2&max id-122078461840982016&q-blue$20angels&rpp-5", 
"page":1, 
"query":"blue*sangels", 
"refresh url":"?since id-122078461840982016&q-blue$20angels", 
"results":[ { 
£T a 


同样 的 : 搜索 关键 字 也 是 url 编 码 过 的 (q-bluecangels) ， 并 且 结 果 是 JSON 数 据 格 式 。 推 
文 数据 在 响应 结果 对 象 中 的 results 数 组 中 。 


由 于 我 们 要 支持 命令 接收 参数 ， 就 像 第 5 章 介 绍 的 那样 ， 我 们 需要 访问 argv。 通 过 使 用 
querystring 模 块 ， 可 以 生成 搜索 URL， 随 后 发 送 请 求 获取 响应 数据 。 这 里 访问 资源 请 求 的 
method 就 很 明显 是 GET 了 ， 端 口 则 是 80， 不 过 这 些 都 是 默认 的 ， 所 以 可 以 省 略 (为 了 让 这 首 
个 HTTP 客 户 端 例子 更 清楚 ， 我 还 是 加 上 了 GET 选 项 ) 。 


var qs = require('querystring') 
, http = require('http') 


var search = process.argv.slice(2).join(' ').trim() 


if (!search.length) { 
return console.log('\n Usage: node tweets «search term» An'); 
} À 
console.log('\n searching for: \033[96m' + search + '\033[39m\n") 
http.request(( 
host: 'search.twitter.com' 
, path: '/search.json?' + qs.stringify(( q: search }) 
), function (res) ( 
var body - ''; 
res.setEncoding('utf8'); 
res.on('data', function (chunk) ( 
body += chunk; 
)); 
res.on('end', function () ( 
var obj - JSON.parse(body): 
obj.results.forEach(function (tweet) ( 
console.log(' \033[90m' + tweet.text + '\033[39m'); 
console.log(' \033[(94m' + tweet.from user + 'X033[39m'); 
console.log('--'); 


运行 上 述 代码 ， 会 校 验 process .argv 数 组 ， 看 是 否 提供 了 搜索 关键 字 ( 见 图 7-19 ) , X 
是 没有 提供 则 会 显示 帮助 信息 
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* node tweets.js 


Usage: node tweets «search term» 





— 了 搜索 关键 字 时 ， 就 会 执行 搜索 如 图 7-20 所 示 。Twitter 会 响应 对 应 的 JSON 
数据 ， 在 end 事 件 处 理 器 中 会 对 该 数据 进行 迭代 ， 并 将 结果 显示 给 用 户 
a OE 1. bash 
* node tweets.js Justin Bieber 


searching for: Justin Bieber 








至 此 ， 我 们 一 直 在 频繁 使 用 http .request， 创建 了 可 以 说 是 最 ESSI MUN gels 
务 通常 by 是 供 相 比 POST 、PUT 而 言 更 多 的 GET 服 务 。 随 着 请 求 发 送 数据 (一 个 请 求 体 ) 
相对 不 怎么 常见 的 


Node.js 也 为 发 送 最 常见 的 请 求 提供 了 便利 ， 它 提供 了 request .get 方 法 。 调 用 Twitter 
API (使 用 http .request ) 的 代码 可 以 重 写 为 如 下 形式 : 
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http.get ({ 
host: 'search.twitter.com' 
, path: '/search.json?' + qs.stringify(( q: search }) 
}, function (res) { 
var body = ''; 
res.setEncoding('utf8'); 
res.on('data', function (chunk) ( 
body += chunk; 
}); 
res.on('end', function () { 
var obj = JSON.parse (body) ; 
obj.results.forEach(function (tweet) { 
console.log(' \033[90m' + tweet.text + '\033[39m'); 
console.log(' \033[94m' + tweet.from_user + '\033[39m'); 
console.log('--'); 
)); 
) 
}) 


唯一 本 质 的 不 同 就 是 这 种 方式 就 无 须 调用 end 方 法 了 ， 并 且 从 语义 上 更 显然 能 够 看 出 是 要 
获取 数据 。 因 为 API 要 接收 一 个 method 参 数 ， 其 默认 值 是 GET， 所 以 这 种 方式 更 简单 有 效 。 


尽管 做 了 上 述 改进 ， 但 我 们 还 是 有 很 多 宛 余 代 码 。 接 下 来 会 介绍 一 款 工具 superagent， 它 
是 基于 HTTP 客 户 端 API 的 更 高 层 封装 ， 可 以 让 上 述 这 些 处 理 变 得 更 加 容易 。 


superagent 来 拯救 

HTTP 客 户 端 往往 都 会 有 一 些 共 性 : 获取 所 有 响应 数据 ， 根 据 响 应 消息 的 Content-Type 
值 进行 数据 解析 ， 处 理 消 息 数据 。 

当 向 服务 器 发 送 数据 时 ， 人 情况 也 是 类 似 的 。 我 们 会 创建 一 个 POST 请 求 ， 然 后 将 要 发 送 的 
数据 对 象 编码 为 JSON 格 式 。 


有 一 个 叫做 superagent 的 模块 通过 扩展 response 对 象 ， 为 其 添加 一 些 有 用 的 扩展 来 解决 上 述 
问题 ， 其 中 部 分 扩展 功能 下 面 会 进行 介绍 。 


本 例 中 ， 我 们 使 用 superagent 0.3.0 版 本 。 创 建 一 个 新 的 目录 ， 然 后 本 地 安装 superagent: 
$ npm install superagent@0.3.0 


通过 request 获 取 数 据 ， 如 果 服 务 器 响应 了 正确 的 Content-Type 并 且 表 明 响 应 数据 是 
JSON 格 式 ， 那 么 superagent 就 会 自动 将 其 进行 缓存 并 解析 ， 然 后 将 数据 放 在 res .body 中 。 我 
们 来 创建 一 个 名 为 tweet.js 的 文件 ， 并 将 下 述 内 容 添 加 到 该 文件 中 : 


var request = require('superagent'); 


request.get('http://twitter.com/search.json') 
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.send(( q: 'justin bieber' )) 
.end(function (res) ( console.log(res.body); }); 


运行 上 述 文件 ， 就 能 看 到 从 响应 的 JSON 数 据 解码 成 的 对 象形 式 的 数据 。 通 过 res .text 
还 是 可 以 获取 到 原始 的 响应 文本 。 

注意 ， 对 于 查询 字符 串 也 无 须 进 行 手动 编码 ， 因 为 ，superagent 知 道 ， 当 发 送 一 个 GET 请 
求 ， 并 且 要 发 送 数据 时 ， 就 需要 将 其 编码 为 查询 字符 串 来 作为 URL 一 部 分 。 


要 设置 请 求 头 信息 ， 可 以 调用 set 方 法 。 如 下 例子 ， 我 通过 set 方 法 设置 了 请 求 的 pate 头 


var request = require('superagent'); 
request.get('http://twitter.com/search.json') 
.send(( q: 'justin bieber' }) 
.set('Date, new Date) 
.end(function (res) { console.log(res.body); }); 


send 和 set 方 法 均 可 被 调用 多 次 ， 并 且 均 为 渐进 式 API: 可 以 进行 链 式 调用 ， 并 最 后 通过 
end 方 法 来 结束 。 

这 类 API 不 仅仅 只 用 于 GET 请 求 。 类 似 的 ，superagent 还 提供 了 put、post、head 以 及 
del 方 法 。 

下 面 的 例子 POST 一 个 JSON 编 码 的 对 象 : 


var request = require('superagent'); 
request.post('http://example.com/') 
.send(( json: 'encoded' )) 
.end(); 


JSON 是 默认 的 编码 格式 。 要 更 改 ， 只 需 简 单 地 调用 set 方 法 来 更 改 请 求 的 Content- 
Type 值 即 可 。 


使 用 up 重启 HTTP 服 务 器 

至 此 ， 或 许 你 已 经 意识 到 ， 每 次 修改 服务 器 端的 代码 后 ， 为 了 让 通过 浏览 器 访问 能 够 看 到 
修改 后 的 效果 ， 都 要 手动 去 重启 服务 器 ， 是 件 很 让 人 例 恼 的 事情 。 

最 直接 的 解决 这 个 问题 的 方法 就 是 一 旦 发 现代 码 有 改动 就 去 重启 该 进程 。 这 在 开发 模式 下 
的 确 很 好 ， 不 过 ， 一 旦 将 Web 服 务 器 部 署 到 生产 环境 之 后 ， 就 得 要 确保 正在 执行 的 请 求 fe] 
话说 ， 即 当 要 重启 进程 时 ， 还 处 在 处 理 过 程 中 的 请 求 ) 不 能 被 杀 掉 。 

为 此 ， 我 开发 了 一 个 名 为 up 的 工具 ， 以 一 种 安全 可 靠 的 方式 来 解决 这 个 问题 。 开 发 模式 
下 ， 通 过 NPM 安 装 即 可 : 


103 


104 


PART || 。Node 重 要 的 API 


$ npm install -g up 

接 下 来 ， 需 要 确保 代码 结构 必须 要 将 Node HTTP 服 务 器 暴露 出 来 ， 而 不 是 调用 1isten 来 
启动 。 这 是 因为 up 会 调用 1isten 方 法 ， 并 且 它 需要 访问 服务 器 实例 。 举 个 例子 ,创建 一 个 新 
目录 ,将 下 述 内 容 添 加 到 server .js 文件 中 : 


module.exports = require('http').createServer(function (reg, res) { 
res.writeHead(200, { 'Content-Type': 'text/html' }); 
res.end('Hello <b>World</b>'); 

Wie 


cd 到 该 目录 ， 通 过 up 命令 ， 同 时 传递 --watch 和 --port 选 项 来 运行 Server .js 文件 : 


$ up -watch -port 80 server.js 

--watch 意 味 着 up 会 通过 Node API 来 监听 该 目录 下 所 有 文件 的 更 改 。 先 试 着 通过 浏览 需 
访问 该 服务 器 ， 然 后 编辑 8erver .js 文件 ， 更改 Hello <b>Wor1lqd<b> 文 本 。 一旦 保存 修改 
的 文件 后 ， 刷 新 浏览 器 就 能 立刻 看 到 修改 后 的 结果 了 ! 


小 结 
本 章 介绍 了 如 何 使 用 Node 来 书写 HTTP 服 务 器 ， 本 章 从 介绍 基于 TCP 协 议 的 HTTP 协 议 基础 
开始 。 


然后 ， 通 过 一 个 Hello World 的 例子 展示 了 Node:js 产 生 的 默认 响应 结果 。 其 中 有 默认 的 头 信 
息 ， 并 介绍 了 为 什么 会 有 这 些 头 信息 。 


之 后 介绍 了 HTTP 请 求 中 这 些 头 信息 的 重要 性 ， 以 及 如 何在 服务 器 端 响应 中 修改 默认 的 头 
言 息 。 还 介绍 了 用 于 浏览 器 和 服务 器 之 间 消 息 传递 的 编码 ， 以 及 Node 提 供 了 哪些 工具 来 对 数 
据 进行 解析 和 处 理 。 


成 功 完 成 了 一 个 Web 服 务 器 之 后 ， 我 们 还 介绍 了 Node 客 户 端 API， 这 对 于 在 现代 Web 时 
代 ， 与 Web 服 务 进行 交互 是 非常 有 用 的 。 再 接着 ， 我 们 在 介绍 了 一 些 常规 的 用 例 后 ， 成 功 地 书 
写 了 一 个 查询 Twitter API 的 客户 端 ， 不 过 在 过 程 中 也 发 现 了 很 多 代码 都 写 重 复 了 。 为 此 ， 我 们 
又 介绍 了 一 个 核心 Node.js 之 上 的 API 来 简化 代码 的 书写 。 下 一 章 要 介绍 的 Connect 模 块 也 是 类 似 
的 解决 方案 ， 它 有 很 多 值得 学 习 的 地 方 。 


最 后 ， 介 绍 了 人 up， 一 个 命令 行 工 具 ( 同时 也 提供 了 JavaScript API) ， 用 它 能 够 让 开发 过 
程 变 得 更 加 简单 ， 每 次 修改 代码 up 就 会 自动 重启 服务 器 进程 来 让 修改 立即 生效 。 要 谨 记 : 要 
使 用 up ， 必 须 确保 模块 要 将 通过 调用 createServer 返 回 的 http .Server 实 例 暴露 出 来 。 
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Connect 





NodeJjs 为 常规 的 网 络 应 用 提供 了 基本 的 API。 至 此 ， 你 也 已 经 了 解 了 其 为 TCP 服 务 器 和 基 <15] 
于 此 的 HTTP 服 务 器 所 提供 的 基本 API 了 。 


然而 ， 实 际 情况 下 ， 绝 大 部 分 网 络 应 用 都 需要 完成 一 系列 类 似 的 操作 ， 这 些 类 似 的 操作 你 
一 定 不 想 每 次 都 重复 地 基于 原始 的 API 去 实现 。 


Connect 是 一 个 基于 HTTP 服 务 器 的 工具 集 ， 它 提供 了 一 种 新 的 组 织 代码 的 方式 来 与 请 求 、 
响应 对 象 进行 交互 ， 称 为 中 间 件 (middleware ) 。 


为 了 证 明 通 过 中 间 件 进行 代码 复 用 的 好 处 ， 假 设 我 们 有 一 个 站 点 ， 其 目录 结构 如 下 所 示 : 


$ ls website/ 
index.html  images/ 


在 images 目 录 下 ， 有 四 个 图 片 文 件 : 


$ ls website/images/ 


1.jpg 2.jpg 3.jpg 4.jpg 


index.html 简 单 地 展示 了 这 四 张 图 片 ， 并 且 可 以 通过 http://localhost 来 访问 ( 见 
图 8-1 ) : 
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http: //127.0.0.1;3000/ 


AOA 2.0. 
4 è| © 127.0.0.1:3000 C | Bemis 
My website 








图 8-1: 一 个 简单 的 静态 网 站 ， 展 示 了 Connect 的 能 力 
ea 的 便利 ， 本 章 会 介绍 如 何 使 用 原生 的 httP API 书 写 一 


个 简单 的 网 站 ， 介绍 如 何 使 用 connect API 完 成 同样 的 事情 。 
使 用 HTTP 构 建 一 个 简单 的 网 立 


按照 惯例 ， 我 们 先 引 入 http 模 块 用 于 创建 服务 器 以 及 fs 模块 ， 用 来 读 取 文件 : 
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server. listen(3000); 


回 到 createServez 的 回调 函数 。 我 们 需要 检查 URL 是 否 和 服务 器 目录 下 的 文件 匹配 ， 
如 果 匹 配 ， 则 读 取 该 文件 并 展示 出 来 。 以 后 ， 可 能 会 添加 更 多 的 图 片 ， 所 以 要 确保 足够 灵活 以 
支持 这 种 情况 。 

首先 要 检查 请 求 方法 是 GET 并 且 URL 以 /images 开 始 、.jpg 结 束 。 如 果 URIL 为 '/' 的话， 
则 响应 index .html (调用 后 面 要 实现 的 serve 国 数 ) 。 否 则 ,发 送 404 Not Found (404 
未 找到 状态 码 ) ， 代 码 如 下 所 示 : 


if ('GET' == req.method && '/images' == req.url.substr(0, 7) 
&& '.jpg' -- req.url.substr(-4)) ( 

) else if ('GET' -- req.method && '/' -- req.url) ( 
serve(__dirname + '/index.html', 'text/html'); 

) else ( 


res.writeHead(404); 
res.end('Not found'); 
) 


接着 使 用 fs . stat 来 检查 文件 是 否 存在 。 这 里 使 用 Node 中 的 全 局 常量 _dirname 来 获取 
当前 服务 器 所 在 的 路 径 。 在 首 个 ifi 滞 句 后 ， 添 加 如 下 代码 : 


fs.stat(  dirname + req.url, function (err, stat) { 


)); 


这 里 不 使 用 同步 版 本 的 fs.stat (fs.statSync) 。 否 则 当 处 理 磁盘 文件 时 ,会 阻塞 其 
他 请 求 的 处 理 ， 这 是 处 理 高 并 发 的 服务 器 的 大 鼠 。 关 于 这 些 ， 我 们 早 在 第 3 章 中 就 讨论 过 。 


如 果 检 查 文件 是 否 存在 时 发 生 错 误 ， 则 终止 进程 并 发 送 HTTP 404 状 态 码 告知 无 法 找到 请 
求 的 图 片 。 对 于 stat 成 功 但 是 路 径 所 表示 的 并 非 是 文件 时 ， 也 要 做 此 处 理 。 如 下 所 示 的 代码 
在 fs . stat 回调 函数 中 。 


if (err || !stat.isFile()) { 
res .writeHead (404) ; 
res.end('Not Found'); 
return; 


} 


否则 ， 就 返回 图 片 信息 。 下 面 这 行 代码 紧 随 上 述 if 之 后 : 
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serve(__dirname + req.url, 'application/jpg'); 

最 后 ， 我 们 完成 serve 方 法 ， 也 许 你 已 经 猜 到 了 ， 这 个 方法 就 是 根据 文件 路 径 来 获取 文件 
内 容 ， 并 添加 必 不 可 少 的 'Content-Type ' 头 信息 ， 如 下 所 示 ， 该 信息 告诉 浏览 器 你 发 送 的 
是 什么 类 型 的 资源 : 


function serve (path, type) { 
res.writeHead(200, { 'Content-Type': type }); 
fs.createReadStream(path) .pipe(res) ; 

} 


还 记得 第 6 章 中 介绍 的 流 (Stream ) 吗 ? HTTP 响 应 对 象 是 一 个 只 写 流 。 从 文件 创建 出 来 的 
流 是 只 读 的 。 同 时 ， 可 以 将 文件 系统 流 接 (Pipe ) 到 HTTP 响 应 流 中 ! 上 述 简洁 的 代码 其 实 就 
等 同 于 如 下 这 段 代 码 : 


fs.createReadStream(path) 
.on('data, function (data) ( 
res.write(data); 
)) 
.on('end', function () ( 
res.end(); 
}) 


这 也 是 最 有 效 的， 推荐 被 用 来 实现 静态 文件 托管 功能 的 方法 。 
把 所 有 代码 整合 起 来 ， 就 变 成 了 : 


/** 


* 模块 依赖 


*j 


var http - require('http') 
, fs = require('fs') 


/** 


* 创建 服务 器 


var server = http.createServer(function (req, res) { 
if ('GET' == req.method && '/images' == req.url.substr(0, 7) 
&& '.jpg' == req.url.substr(-4)) { 
fs.stat(,. dirname + req.url, function (err, stat) { 
if (err || !stat.isFile()) { 
res.writeHead (404) ; 
res.end('Not Found'); 
return; 
} 
serve(__dirname + req.url, 'application/jpg'); 
}); 
} else if ('GET' == req.method && '/' == req.url) { 
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serve(__dirname + '/index.html', 'text/html'); 
else { 


~ 


res.writeHead (404) ; 
res.end('Not found'); 
} 


function serve (path, type) { 
res.writeHead(200, { 'Content-Type': type }); 
fs.createReadStream(path) .pipe(res) ; 


* 监听 
ay 


server.listen(3000); 
完成 ! 接 下 来 就 运行 上 述 代码 : 
$ node server 


然后 通过 浏览 器 访问 http://127.0.0.1:3000， 就 能 看 到 实现 的 网 站 了 1! 


通过 Connect 实 现 一 个 简单 的 网 站 
接 下 来 这 个 例子 是 要 实现 一 个 网 站 ， 该 例子 展示 了 创建 网 站 时 一 些 常 见 的 任务 : 
" 托管 静态 文件 。 
" 处 理 错误 以 及 损坏 或 者 不 存在 的 URL。 
= 处 理 不 同类 型 的 请 求 。 


基于 http 模 块 API 之 上 的 Connect， 提 供 了 一 些 工具 方法 能 够 让 这 些 重复 性 的 处 理 便于 


实现 ， 以 至 于 让 开发 者 能 够 更 加 专注 在 应 用 本 身 。 它 很 好 地 体现 了 DRY 模 式 : 不 要 重复 自己 
(Don’t Repeat Yourself) 。 


归功 于 Connect， 本 例 实现 起 来 会 非常 简单 。 首 先 在 新 目录 下 创建 一 个 package .json 文 
件 ， 并 在 其 中 声明 对 "connect" 模 块 的 依赖 。 


{ 
"name": "my-website" 
, "version": "0.0.1" 
, "dependencies": ( 
"connect": "1.8.7" 
) 
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接着 ， 安 装 依赖 : 
$ npm install 


然后 ， 引 入 connect 模 块 : 


je 
* 模块 依赖 


/ 


var connect - require('connect') 


通过 Connect 创 建 http.Server: 


“+ 创建 服务 器 
*J 


var server = connect.createServer(); 

使 用 use 0 方法 来 添加 static 中 间 件 。 下 一 部 分 会 介绍 中 间 件 的 概念 ， 并 在 下 一 章 会 对 
其 做 深入 讲解 。 现 在 ， 最 为 重要 的 是 要 理解 ， 中 间 件 其 实 就 是 一 个 简单 的 JavaScript 函 数 。 本 
例 中 ,我 们 这 样 配置 static 中 间 件 一 一 通过 传递 一 些 参数 给 connect . static 方 法 ， 该 方法 
本 身 会 返回 一 个 方法 。 


jee 
* 处 理 静态 文件 


/ 


server .use(connect.static(__dirname + '/website')); 


将 index.htm1l 以 及 images 目 录放 到 /website 下 ， 确 保 没 有 将 不 想 托管 的 文件 放 进 去 。 
接着 ， 调 用 1isten () 方 法 : 


* 监听 


*/ 


server.listen(3000); 


完成 ! 事实 上 ，Connect 还 能 处 理 404 的 情况 ， 你 可 以 通过 访问 /made-up-url 来 验证 。 


[2 ^ 中 间 件 
为 了 更 好 地 理解 中 间 件 ， 我 们 回 到 node HTTP 的 例子 。 移 除 逻 辑 ， 我 们 来 关注 如 下 部 分 ， 


if ('GET' == req.method && '/images' == req.url.substr(0, 7)) ( 
// serve image 


) else if ('GET' == req.method && '/' == req.url) ( 
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// serve index 
) eise ( 

// display 404 
) 


如 上 述 代 码 所 示 ， 针 对 每 个 请 求 应 用 都 只 会 做 这 三 件 事情 中 的 一 件 。 比 如 ， 若 还 要 记录 请 
求 日 志 ， 就 在 顶部 加 上 如 下 代码 : 

console.error(' $s $s ', req.method, req.url); 

下 面 ， 我 们 来 设计 一 个 更 大 型 的 应 用 ， 它 能 够 根据 每 个 请 求 的 不 同情 况 处 理 以 下 这 几 种 不 
同 的 任务 : 

" 记录 请 求 处 理 时 间 。 

" 托管 静态 文件 。 

" 处 理 授权 。 

当然 ， 这 些 任 务 的 处 理 代码 都 可 以 放 在 一 个 简单 的 事件 处 理 器 中 〈createServez 的 回 
调 函 数 中 ) ， 这 将 会 是 一 个 非常 复杂 的 处 理 过 程 。 

简单 来 说 ， 中 间 件 由 函数 组 成 ， 它 除了 处 理 *req 和 res 对 象 之 外 ， 还 接收 一 个 next 函 数 来 
做 流 控制 。 

若 用 中 间 件 模式 来 书写 满足 上 述 要 求 的 应 用 ， 会 是 这 样 的 : 

server.use(function (req, res, next) { 

// 记 录 日 志 

console.error(' %s %s ', req.method, req.url); 


next (); 
)); 


server.use(function (req, res, next) ( 


if ('GET' -- req.method && '/images' -- req.url.substr(0, 7)) ( 
// 托管 图 片 

} else { 
// 交 给 其 他 的 中 间 件 去 处 理 
next (); 


} 
}); 


server.use(function (req, res, next) { 


if ('GET' == req.method && '/' == req.url) { 
// 响应 index 文 件 
} else { 


// 交 给 其 他 中 间 件 去 处 理 
next (); 


} 
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)); 


server.use(function (req, res, next) { 
// 最 后 一 个 中 间 件 ， 如 果 到 了 这 里 ， 就 意味 着 无 能 为 力 ， 只 能 返回 404 了 
res.writeHead (404); 
res.end('Not found') ; 


)); 


使 用 中 间 件 ， 不 仅 能 够 让 代码 有 更 强大 的 表达 能 力 〈 将 应 用 拆 分 为 更 小 单元 的 能 力 ) ， 还 
能 够 实现 很 好 的 重用 性 。 我 们 马上 就 会 看 到 ，Connect 已 经 为 处 理 常 见 的 任务 提供 了 对 应 的 中 
间 件 。 例 如 ， 要 对 请 求 进行 日 志 记 录 ， 就 可 以 简单 地 通过 如 下 一 行 代码 完成 : 


app.use(connect.logger('dev')) 
帮 你 完成 日 志 记 录 ! 
下 一 部 分 会 介绍 如 何 书写 一 个 当 请 求 处 理 时 间 过 长 而 进行 警告 的 中 间 件 。 





书写 可 重用 的 中 间 件 

一 个 用 于 当 请 求 时 间 过 长 而 进行 提醒 的 中 间 件 在 很 多 场景 下 都 非常 有 用 。 比 如 ， 假 设 有 个 
页 面 会 向 数据 库 发 起 一 系列 的 请 求 。 在 测试 过 程 中 ， 所 有 响应 都 在 100 毫 秒 (ms) 内 完成 ， 但 
是 你 要 确保 能 够 将 响应 时 间 大 于 100ms 的 请 求 记录 下 来 。 

为 此 ， 我 们 在 一 个 名 为 request-time . js 的 独立 模块 中 创建 一 个 中 间 件 。 

这 个 模块 暴露 一 个 函数 ， 此 函数 本 身 又 返回 一 个 函数 。 这 对 于 可 配置 的 中 间 件 来 说 是 很 党 
见 的 写法 。 在 前 面 的 例子 中 ,我 们 调用 connect . 1ogger 时 传递 了 一 个 参数 ， 然 后 它 自身 会 
返回 一 个 函数 ， 最 终 用 来 处 理 请 求 。 

目前 ， 模 块 就 接收 一 个 超时 时 间 阔 值 选项 ， 该 选项 用 来 界定 什么 时 候 该 将 其 记录 下 来 。 


/ ** 
* 请 求 时 间 中 间 件 











* 选项 : 
- ‘time’ ('Number'): EBAY [S] IÉ ( 默认 100 ) 


* @param {Object} options 


* @api public 
*y 


module.exports = function (opts) { 
D a 
); 
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var time = opts.time || 100; 
随后 ， 返 回 一 个 中 间 件 函数 : 


return function (req, res, next) { 


中 间 件 本 身 创建 一 个 计时 器 ， 并 在 指定 时 间 内 触发 : 


var timer = setTimeout(function () { 
console. log ( 
'N033[90m$s $sX033[39m \033[91lmis taking too long! \033[39m' 
, req.method 
, req.url 
) 
), time); 


这 里 要 确保 当 响 应 时 间 在 100ms 以 内 时 要 清除 ( 停 下 来 或 者 取消 ) 计时 器 。 另 外 一 个 在 中 
间 件 中 常用 的 模式 叫做 重 写 方法 ( 也 叫 猴 子 补丁 ( monkey-patch ) ) ， 能 够 在 其 他 中 间 件 调用 
它 时 ， 执 行 指定 的 行为 。 


在 本 例 中 ， 当 响应 结束 时 ， 我 们 需要 清除 计时 器 : 


var end = res.end; 

res.end = function (chunk, encoding) { 
res.end = end; 
res.end(chunk, encoding) ; 
clearTimeout (timer) ; 


}; 


首先 保持 对 原始 函数 的 引用 (var end = res.enad) 。 然 后 ， 在 重 写 的 函数 中 ， 再 恢 
复原 始 函 数 ， 并 调用 它 ， 最 后 清除 计时 需 。 
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最 后 ， 总 是 要 让 其 他 中 间 件 能 够 处 理 请 求 ， 所 以 得 调用 next。 和 否则， 程序 不 会 做 任何 事 <14 


情 ! 
next (); 


完整 版 的 中 间 件 代码 如 下 所 示 : 


y ** 
* 请 求 时 间 中 间 件 
* 选项 : 
— 'time' (‘Number’): 超时 间 值 ( 默认 100 ) 


* @param {Object} options 
* @api public 
ies 
module.exports = function (opts) { 


var time = opts.time || 100; 
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return function (req, res, next) ( 
var timer - setTimeout(function () ( 


console.log( 
'N033[90m$s $sX033[39m X033[91mis taking too long! V033[39m' 


, req.method 
, req.url 
) ; 
}, time); 


var end = res.end; 

res.end = function (chunk, encoding) { 
res.end = end; 
res.end(chunk, encoding) ; 
clearTimeout (timer) ; 

) 

next(); 

}; 
}; 


为 了 测试 上 述 例子 ， 我 们 需要 创建 一 个 Connect 应 用 ， 并 创建 两 条 路 由 : 第 一 条 很 快 得 到 
响应 ， 另 外 一 条 1 秒 后 得 到 响应 。 


我 们 先 来 引入 依赖 的 模块 : 


# sample.js 
/** 
* 模块 依赖 


*4 


var connect - require('connect') 


, time - require('./request-time') 


[25 > 接着 ,创建 服务 器 : 


j** 
* 创建 服务 器 


+y 


var server = connect.createServer(); 
记录 请 求情 况 : 
/** 


* 记录 请 求情 况 


server.use(connect.logger('dev')); 


实现 中 间 件 : 


/ ** 
* 实现 时 间 中 间 件 
¥/ 


server.use(time({ time: 500 })); 


实现 快速 响应 : 
y ** 

* 快速 响应 

*T 


server.use(function (req, res, next) { 
if ('/a' == req.url) ( 
res.writeHead(200); 


res.end('Fast!'); 


) else ( 
next(); 
) 
y)a 
实现 模拟 的 慢 速 响应 : 
/ ** 
x 慢 速 响应 
xf 


server.use(function (req, res, next) { 
if ('/b' == redq.url) { 
setTimeout (function () { 


res .writeHead (200) ; 


res.end('Slow!'); 
Ja 1000); 
) else ( 
next(); 
} 
Me 


服务 器 监听 端口 : 
/|** 

* 监听 

"d 
server.listen(3000); 


运行 服务 器 : 


$ node server 
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用 浏览 器 访问 http://Localhost:3000/a (快速 响应 ) ， 如 图 8-2 所 示 。 
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图 8-4 显 示 了 


eoo 


http://127.0.0.1:3000/a 


** 127.0.0.1:3000 





个 简单 的 路 由 ( /a ) £ 


TEASE 


慢 


AB 
速 啊 


i E3 — Zr 3l 
吉 果 显示 在 浏 


1. node 


时， 显示 在 控制 台 的 日 志 


响应 的 结果 ( 


http://127.0.0.1:3000/b 


4) © 127.0.0.1:3000 


图 8-$ 显 示 了 





b 结 果 显 示 在 浏览 器 中 


对 应 的 控制 台 信息 。 


T 


|^. dun 
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图 8-5: 处 理 /b 后 ， 控 制 台 输出 了 警告 日 志 
接 下 来 ,我 们 会 介绍 Connect 内 置 的 一 些 中 间 件 ， 这 些 中 间 件 在 Web 应 用 中 都 是 非常 党 
FAR. 


static 中 间 件 可 以 算得 上 是 使 用 Node 开 发 Web 应 用 时 最 常用 的 中 间 件 之 一 了 。 


H 


Connect 人 允许 中 间 件 挂 载 到 URL 上 。 比 如 ，static 人 允许 将 任意 一 个 URL 匹 配 到 文件 系统 中 
任意 一 个 目录 

举例 来 说 ， 假 设 要 让 /my-images URL 和 名 为 /images 的 目录 对 应 起 来 ， 可 以 通过 如 下 
方式 进行 挂 载 : 


maxAge 
Ce 这 个 选项 代表 一 个 资源 在 客户 端 缓存 的 时 
间 。 这 非常 实用 ， 特 别 是 对 一 些 不 经 常 改 动 的 资源 来 说 ， 浏 览 器 就 无 须 每 次 都 去 请 求 它 了 
比如 ， 一 种 Web 应 用 常见 的 实践 方式 就 是 将 所 有 的 客户 端 JavaScript 文 件 都 合并 到 一 个 
文件 中 ， 并 在 其 文件 名 中 加 上 修订 号 。 这 个 时 候 ， 就 可 以 设置 maxAge 选 项 ， 让 其 永远 缓存 


hidden 


男 一 个 static 接 收 的 参数 是 hidden。 如 果 该 选项 为 true，Connect 就 会 托管 那些 文件 名 
以 点 C.) 开始 的 在 UNIX 文 件 系 统 中 被 认为 是 隐藏 的 文件 : 


static('/path/to/resources', hidden: true 
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query 中 间 件 

有 时 要 发 送 给 服务 器 的 数据 会 以 查询 字符 串 形式 ， 作 为 URL 的 一 部 分 。 

比如 ，url /blog-posts?page=5。 当 在 浏览 器 中 访问 该 URI 时 ，Node 会 以 字符 串 的 形 
式 将 该 URL 存 储 到 req.ur1 变 量 中 : 


server.use(function (req) { 
// xeq.url == "/blog-posts?page-5" 
}) 


而 绝 大 多 数 情况 下 ， 真 正 想 要 获取 的 其 实 是 查询 字符 串 这 部 分 的 数据 。 
使 用 query 中 间 件 ， 就 能 够 通过 rea. query 对 象 自 动 获取 这 些 数据 : 


server.use(connect.query); 
server.use(function (req, res) ( 
// req.query.page == "5" 


j)? 

同样 的 ， 解 析 查 询 字 符 串 也 是 应 用 常见 的 需求 ，Connect 也 对 其 做 了 简化 。 就 像 刚刚 提 到 
的 static 中 间 件 ， 你 无 须 关 心 使 用 require 去 引入 fs 模块 的 问题 一 样 ， 你 也 无 须 去 担心 使 用 
querystring 模 块 的 问题 。 

quezy 中 间 件 在 Express 中 默认 就 是 启用 的 ，Express 是 一 个 Web 框 架 ， 我 们 会 在 下 一 章 中 
做 介绍 。 接 下 来 要 介绍 另 一 个 很 实用 的 中 间 件 





logger, 


logger [8] 4 
logger 中 间 件 是 一 个 对 Web 应 用 非常 有 用 的 诊断 工具 。 它 将 发 送 进来 的 请 求 信息 和 发 送 


出 去 的 响应 信息 打印 在 终端 。 
它 提供 了 以 下 四 种 日 志 格 式 : 
= default 
= dev 
* short 
= tiny 


比如 ， 要 使 用 dev 日 志 格 式 ， 可 以 通过 如 下 初始 化 1ogger 中 间 件 的 方式 : 
Sserver.use(connect.logger('dev')); 


看 下 面 这 个 例子 ， 一 个 典型 的 使 用 了 logger 中 间 件 的 “Hello World” HTTP 服务 器 : 


注意 ， 在 上 述 代码 中 ， Pale 了 一 系列 中 间 件 函数 作为 createServezr 的 参数 。 这 其 实 
就 等 同 于 初始 化 Connect 服 务 器 时 调用 use 两 次 


当 通 过 浏览 器 访问 http://127.0.0.1:3000 时 ， 就 能 看 到 如 下 两 行 输 出 信息 : 


上 述 信息 表示 浏览 器 正在 请 求 /favicon.ico 和 /，connect logger 中 间 件 将 请 求 的 方法 、 
响应 状态 码 以 及 处 理 时 间 输 出 

dev 是 一 种 精准 简短 的 日 志 格 式 ， 能 够 提供 行为 以 及 性 能 方面 的 信息 ， 方 便 测试 Web 应 用 

logger 中 间 件 还 允许 自 定义 日 志 输 出 格式 


比如 ， 阁 只 想 记录 请 求 方法 和 JP 地址: 


另外 ， 还 能 够 通过 动态 的 zed 和 zes 来 记录 头 信 息 。 要 记录 响应 的 content-1ength 和 
content-type 信 息 ， 可 以 通过 如 下 方式 : 


MEExR. Ga fy EN EE pty ep bee IE gh 
E: ?人 性 ， 在 Node 中 ， TH oR ) 应 头 SR ze]. d] 


要 是 把 上 述 代码 应 用 到 请 PRATER 的 例子 ， 就 能 看 到 很 有 趣 的 输出 结果 ， 如 图 8-6 所 


示 。( 确保 在 没有 缓存 的 情况 下 。 ) 


eoo 1. node 


f node server.js 

type is text/html; charset=UTF-8, length is 126 and it took 
4 ms, 

type is image/jpeg, length is 103298 and it took 9 ms. 

type is image/jpeg, length is 124504 and it took 9 ms. 


type is image/jpeg, length is 132904 and it took 8 ms. 
type is image/jpeg, length is 81636 and it took 6 ms. 
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下 面 是 完整 的 可 用 token: 

* :req[header] (lll: reg[Accept] ) 

* :res[header] (如 :res[Content-Length] ) 
a :http-version 

=" :response-time 


a :remote-addr 


" :date 
a :method 
* :url 


" :referrer 
a suser-agent 
s :status 
logger 还 能 够 自 定义 token。 比 如 ， 要 给 请 求 的 Content-Type 定 义 一 个 简写 的 :type 
token， 就 可 以 采用 如 下 方式 : 


connect.logger.token('type', function (req, res) { 
return req.headers['content-type']; 
}); 


接 下 来 要 介绍 的 是 body parse 中 间 件 ， 它 可 以 自动 帮 你 完成 另 一 件 开 发 Web 应 用 常见 的 任 
务 。 


body parser 中 间 件 
在 一 个 使 用 http 模 块 的 例子 中 ， 我 们 用 了 gs 模块 来 解析 POST 请 求 的 消息 体 。 


Connect 也 对 这 部 分 提供 了 帮助 ! 它 提 供 了 bodyParsezr 中 间 件 : 
server.use(connect.bodyParser()); 


然后 ， 就 能 够 在 req .body 中 获取 POST 请 求 的 数据 了 : 


server.use(function (req, res) { 
// reg.body.myinput 
); 


如 果 客 户 端 在 POST 请 求 中 使 用 了 JSON 格 式 ， 那 么 regq.body 也 会 对 应 地 转换 为 JSON 对 
象 ， 因 为 bodyParser 会 检测 Content-Type 的 值 。 
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处 理 上 传 
bodyParser 另 一 个 功能 就 是 使 用 formidable 模 块 ， 它 可 以 让 你 处 理 用 户 上 传 的 文件 。 


本 例 中 ,我 们 可 以 使 用 createServer 的 快捷 方式 来 创建 一 个 服务 器 ， 并 将 所 有 要 用 的 
中 间 件 都 传递 给 它 : 


var server = connect ( 
connect .bodyParser () 
, connect.static('static') 
); 


在 static/ 文 件 夹 中 ,我 们 创建 一 个 包含 用 来 处 理 文件 上 传 表单 的 index html: 


<form action="/" method="POST" enctype="multipart/form-data"> 
<input type="file" /> 
<button>Send file!</button> 


</form> 
接着 ， 我 们 可 以 添加 一 个 简单 的 中 间 件 来 看 一 人 zeq.body.fle 值 是 什么 样子 的 : 


function (req, res, next) { 


if ('POST' == req.method) { 
console.log(req.body. file) ; 
} else { 
next (); 


} 
} 


到 测试 时 间 了 ! 如 图 8-7 所 示 ， 上 传 一 个 Hello .txt 文 件 来 测试 一 下 。 








图 8-7: 从 浏览 器 上 传 一 个 示例 文本 文件 
接着 ， 我 们 看 看 服务 端的 输出 结果 ， 如 图 8-8 所 示 。 


如 图 8-8 中 所 示 ， 我 们 获取 到 一 个 包含 了 许多 有 用 的 上 传 信息 的 对 象 。 接 着 ， 我 们 把 上 传 
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x 





的 文件 返回 给 用 户 : 
133 > 
O O 1. node 


server.js 
23, 
'/tmp/042e078b76ccd06995fefda&8d270c639' , 
'Hello.txt', 
type: 'text/plain', 
lastModifiedDate: Mon, 30 Apr 2012 21:06:25 GMT, 
_writeStream: 
{ path: '/tmp/042e078b76ccd06995fefda8d270c639' , 
fd: 8, 
writable: false, 
flags: 'w', 
encoding: 'binary', 
mode: 438, 
bytesWritten: 23, 
busy: false, 
-queue: [], 
drainable: true }, 
length: [Getter], 
filename: [Getter], 
Ij mime: [Getter] } 





2. n. 7 >| 去 立 件 对 会 3 Ar ty 


再 次 上 传 该 文件 来 看 看 返回 结果 ( 见 图 8-9 ) 
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http://127.0.0.1:3000/ 
[© 227.0.0.:3000 — 











图 8-9: 上 传 成 功 后 ， 示 例文 件 Hello .txt 内 容 显示 在 浏览 器 中 


多 文件 上 传 
要 处 理 多 文件 上 传 也 很 简单 ， 只 要 在 input 的 name 属 性 上 加 上 [] 即 可 : 


<input type="file" name="files[]" /> 


«input type-"file" name-"files[]" /> 


req.body .files 就 包含 了 一 个 数组 ， 数 组 中 的 元 素 就 是 此 前 单个 Hello .txt 示 例 的 对 象 。 


cookie 
除了 query 之 外 ，Connect 还 为 读 写 cookie 提 供 了 便利 。 


当 浏览 器 发 送 cookie 数 据 时 ， 会 将 其 写 到 cookie 头 信息 中 。 其 数据 格式 和 URL 中 的 查询 
字符 串 类 似 。 我 们 来 看 下 面 这 个 包含 了 该 头 信息 的 请 求 : 


GET /secret HTTP/1.1 
Host: www.mywebsite.org 
Cookie: secretl=value; secret2=value2 


Accept: */* 


要 访问 这 些 值 ( secret1 和 secret2 ) ， 但 又 不 想 手动 去 解析 ， 也 不 想 使 用 正则 表达 式 
去 抽取 的 话 ， 就 可 以 使 用 cookieParser 中 间 件 : 


server .use (connect .cookieParser () ) 


然后 ， 就 可 以 通过 req .cookies 对 象 来 访问 这 些 cookie 数 据 了 : 


server.use(function (req, res, next) { 
// req.cookies.secretl = "value" 
// req.cookies.secret2 = "value2" 


}) 
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会 话 (session) 

在 绝 大 多 数 Web 应 用 中 ， 多 个 请 求 间 共享 “用 户 会 话 ”的 概念 是 非常 必要 的 。“ 登 录 ” 一 
个 网 站 时 ， 多 多 少 少 会 使 用 某 种 形式 的 会 话 系 统 ， 它 主要 通过 在 浏览 器 中 设置 cookie 来 实现 ， 
该 cookie 信 息 会 在 随后 所 有 的 请 求 头 信息 中 被 带 回 到 服务 器 。 


Connect 为 此 也 提供 了 简单 的 实现 方式 。 作 为 例子 ， 我 们 创建 了 一 个 简单 的 登录 系统 。 我 
们 把 用 户 凭证 信息 存放 在 一 个 名 为 users .json 的 文件 中 : 


"tobi". { 
"password": "ferret" 
, "name": "Tobi Holowaychuk" 
) 
) 


首先 ， 通 过 require 载 人 Connect 和 users 文 件 : 


/** 
* 模块 依赖 


var connect = require('connect') 


, users = require('./users') 
注意 ， 这 里 直接 require 了 JSON 文 件 ! 当 你 只 是 要 对 外 暴露 数据 时 ， 就 不 需要 加 上 
module.exports， 直 接 把 数据 文件 以 JSON 形 式 暴 露出 来 就 好 了 。 


接着 , 我们 加 上 1logger、bodyParser 和 session 中 间 件 。 由 于 session 中 间 件 需要 操 
作 cookie， 所 以 在 这 之 前 先 要 引入 cookieParser 中 间 件 : 


var server = connect ( 
connect. logger ('dev') 
, connect .bodyParser () 
, connect .cookieParser () 


, connect.session({ secret: 'my app secret' }) 


出 于 安全 性 的 考虑 ， 在 初始 化 session 中 间 件 的 时 候 需 要 提供 secret 选 项 。 
接 下 来 ,我 们 首先 检查 用 户 是 否 已 经 登录 。 如 果 没 有 登录 ， 则 交 给 其 他 中 间 件 处 理 : 


, function (req, res, next) { 
if ('/' == req.url && req.session.logged_in) { 
res.writeHead(200, { 'Content-Type': 'text/html' )); 
res.end( 
'Welcome back, <b>' + req.session.name + '«/b». ' 
+ '«a href="/logout">Logout</a>' 
) 7 


} else { 


CHAPTER 8 。 


next (); 


紧 接着 的 中 间 件 ， 展 示 一 个 登录 表单 : 


, function (req, res, next) { 
if ('/' == req.url && 'GET' == req.method) { 
res.writeHead(200, { ‘Content-Type’: 'text/html' }); 
res.end([ 
‘<form action-"/login" method="POST">' 
» '«fieldset»' 
" '«legend»Please log in</legend>' 


" '«p»User: «input type="text" name="user"></p>' 


’ '«p»Password: <input type="password" name-"password"»«/p»' 


'«button»Submit«/button»' 
'«/fieldset»' 
, '«/form»' 
].join('')):; 
) else { 


next(); 


) 


再 后 面 的 中 间 件 检查 登录 表单 的 信息 是 否 与 用 户 凭证 匹配 ， 匹 配 则 认为 登录 成 功 : 


, function (req, res, next) { 
if ('/login' == req.url && 'POST' == req.method) { 
res .writeHead (200) ; 


if (!users[req.body.user] || req.body.password != users[req.body.user]. 


password) ( 
res.end('Bad username/password'); 
) eise ( 
req.session.logged in - true; 
req.session.name - users[req.body.user].name; 
res.end('Authenticated!'); 
} 
} else { 


next (); 


} 


Connect 


注意 在 上 述 代 码 中 ， 修 改 了 一 个 名 为 req.session 的 对 象 。 该 对 象 在 响应 发 送出 去 
时 就 会 自动 保存 ， 无 须 我 们 手动 处 理 。 上 述 代码 中 将 在 session 对 象 上 存储 name， 以 及 将 


logged in 标记 为 true。 
最 后 处 理 登 出 : 


, function (req, res, next) { 
if ('/logout' -- req.url) ( 


req.session.logged in = false; 
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res.writeHead (200); 

res.end('Logged out!'); 
) else ( 

next(); 


) 


[187 > 完整 的 代码 如 下 所 示 : 


/** 
* Module dependencies 
Ey 


var connect = require('connect') 


|, users = require('./users') 


/** 
* Create server 
*7 


var server - connect( 
connect.logger('dev') 
, connect.bodyParser() 
, connect.cookieParser() 
, connect.session(( secret: 'my app secret' }) 
, function (req, res, next) ( 
if ('/' == req.url && req.session.logged in) { 
res.writeHead(200, ( 'Content-Type': 'text/html' }); 
res.end( 
‘Welcome back, «b»' + req.session.name + '«/b». ' 
+ '«a href="/logout">Logout</a>' 
) ; 
} else { 


next (); 


} 
, function (req, res; next) { 
if ('/' == req.url && 'GET' == req.method) ( 
res.writeHead(200, ( 'Content-Type': 'text/html' )); 
res.end([ 
‘<form action-"/login" method="POST">' 
5 '«fieldset»' 
> '<legend>Please log in</legend>' 
" ‘<p>User: <input type="text" name="user"></p>' 
A '<p>Password: <input type="password" name="password"></p>' 
x ‘<button>Submit</button>' 
i '</fieldset>' 
, '«/form»' 
1.join(**)):; 
) else ( 


next (); 
} 
} 
, function (req, res, next) { 
if ('/login' == req.url && 'POST' == req.method) 
res.writeHead (200) ; 
if (!users[req.body.user] || req.body.password 


password) { 


res.end('Bad username/password' ) ; 
} else { 
req.session.logged_in = true; 
req.session.name = users[req.body.user].name; 
res.end('Authenticated!'); 
) 
) else ( 


next(); 


) 
, function (req, res, next) ( 
if ('/logout' == req.url) { 
req.session.logged in - 
res.writeHead(200); 
res.end('Logged out!'); 


false; 


) eise ( 
next (); 
} 
} 
): 
fz 
* Listen. 
wp 


server.listen(3000); 
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( 


!- users[req.body.user]. 
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下 面 来 试 试 这 个 简单 的 登录 系统 。 首 先 来 测试 一 下 基本 的 认证 功能 是 否 正常 工作 ， 如 


图 8-10 和 图 8-11 所 示 。 


Bee  pj//127001300/. 


Lt Le] 6 127.0.0.1:3000 





图 8-10: 使 用 错误 的 认证 信息 登录 
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eoe j http:// 127.0.0.1:3000/login 
(hist) | © 127.0.0.1:3000 001 


Bad username/password 











图 8-11: 结果 显示 登录 失败 
下 面 ， 用 正确 的 信息 登录 ， 如 图 8-12 所 示 。 


eoe http://127.0.0.1:3000/ 
Lala] [© 1270013000 





图 8-12: 有 效用 户 登 录 
图 8-13 展 示 了 成 功 登 录 的 情况 。 


eoe http://127.0.0.1:3000/login Pu 
kalm 0 127001300 00 


Authenticated! 





图 8-13: 登录 成 功 
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如 图 8-14 所 示 ， 登 录 成 功 后 ， 返 回首 页 。 






eoe http://127.0.0.1:3000/ " 
ala || @ 127.0.0.1:3000 © | Reacieruli 
TEE SERI ET METAAN IST REI ATE WEIT TED 









Welcome back, Tobi Holowaychuk. Logout 


图 8-14: 登录 成 功 后 回 到 首页 
为 了 让 senssion 能 够 在 生产 环境 中 也 正常 工作 ， 我们 需要 学 习 如 何 通 过 Redis 来 实现 一 个 持 
久 化 的 session。 


Redis session 

尝试 这 样 一 件 事 情 : 登录 后 ， 重 启 node 服 务 器 ， 然 后 刷新 浏览 器 。 注 意 到 没有 ，session 丢 
TI 

原因 就 在 于 session 默 认 的 存储 方式 是 在 内 存 。 这 就 意味 着 session 数 据 都 是 存储 在 内 存 中 
的 ， 当 进程 退出 后 ，session 数 据 自然 也 就 丢失 了 。 

这 对 于 开发 过 程 并 不 算 什么 坏事 ， 但 是 对 于 线 上 的 应 用 来 说 ， 简 直 就 是 不 能 忍受 的 。 生 产 
环境 中 ， 需 要 使 用 一 种 当 应 用 重启 后 ， 还 能 够 将 session 信 息 持 和 久 化 存储 下 来 的 机 制 ， 如 Redis 
(第 12 章 会 详细 介绍 Redis ) 。 

Redis 是 一 个 既 小 又 快 的 数据 库 ， 有 一 个 connect-redis 模 块 使 用 Redis 来 持久 化 session 
数据 ， 这 样 就 让 session 驻 扎 到 了 Node 进 程 之 外 。 


通过 如 下 方式 来 使 用 该 模块 〈 必须 要 安装 好 Redis ) : 


var connect = require('connect') 


, RedisStore = require('connect-redis') (connect); 
然后 ， 将 其 作为 store 选 项 的 值 传递 给 session 中 间 件 : 


server.use(connect.session({ store: new RedisStore, secret: 'my secret' })) 


完成 ! 现在 session 已 经 脱离 Node 进 程 了 。 


13] 


132 


PART Ill 。 Web 开 发 


methodOverr ide # [8] ff- 


一 些 比较 早期 的 浏览 器 并 不 支持 创建 如 PUT、DELETE 、BPRATCH 这 样 的 请 求 (如 Ajax ) 。 


常见 的 解决 方案 就 是 在 GET 或 者 POST 请 求 中 加 上 一 个 _method 变 量 来 模拟 上 述 这 些 请 求 。 


举例 来 说 ， 要 想 在 正中 发 送 一 个 PUT 请 求 ， 可 以 采用 如 下 方式 : 


POST /url?_method=PUT HTTP/1.1 


为 了 让 后 台 的 处 理 程序 能 够 觉得 这 是 一 个 PUT 请 求 ， 可 以 使 用 methodoverride 中 间 件 : 


server.use(connect.methodOverride()) 


这 里 要 记 住 的 是 ， 中 间 件 是 串 行 执行 的 ， 所 以 务必 要 确保 把 它 放 在 其 他 处 理 请 求 中 间 件 


之 前 。 


basicAuth 中 间 件 


有 些 项 目 需要 对 客户 端 进行 基本 的 身份 验证 ( 见 图 8-15 ) 。 


http://127.0.0.1:3000/ 
[ale] | © 127.0.0.1:3000 — 


a To view this page, you must log in to this area 
的 on 127.0.0.1:3000: 











Authorization Required 
Your password will be sent unencrypted 


Mame fd 


Password: | 





|. | Remember this password in my keychain 


区 ET 






图 8-15: 浏览 器 端 显 示 了 一 个 登录 框 ( 基本 身份 验证 ) 
为 此 ，Connect 也 提供 了 一 个 名 为 basicauth 的 中 间 件 。 


作为 例子 ， 我 们 来 创建 一 个 简单 的 身份 验证 系统 ， 并 且 通 过 命令 行 对 用 户 进行 验证 操作 。 
首先 实现 用 户 输入 : 


process.stdin.resume(); 


process.stdin.setEncoding('ascii'); 


接着 ， 添 加 basicAuth 中 间 件 : 


connect.basicAuth(function (user, pass, fn) { 


process.stdout.write('Allow user X033[96m' .« user + '\033[39m ' 


+ ‘with pass \033[90m' + pass + '\033[39m ? [y/n]: '); 
process.stdin.once('data', function (data) { 
if (data[0] == 'y') { 
fn(null, ( username: user )); 
) 
else fn(new Error('Unauthorized')); 
1); 
}) 


注意 了 ， 上 述 代码 在 stdin EventEmitter 上 使 用 了 once 方 法 ， 这 是 因为 我 们 只 需要 对 


每 个 请 求 获取 一 次 数据 。 


basicAuth 使 用 起 来 非常 简单 。 它 提供 了 user 和 pass 作 为 参数 ， 同 时 还 提供 了 一 个 回 


调 函 数 来 告诉 你 验证 成 功 还 是 失败 。 


如 果 验 证 通过 ， 就 传递 nul1 作 为 第 一 个 参数 ( 反之 ， 则 传递 一 个 Error 对 象 ) ， 以 及 


user 对 象 用 来 生成 req .remoteUser 对 象 ( 供 后 续 的 中 间 件 使 用 ) 。 
然后 ， 继 续 声明 下 一 个 中 间 件 ， 它 会 在 验证 成 功 后 执行 。 
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Connect 


, function (req, res) { res.writeHead(200); res.end('Welcome to the protected area, 


' + req.remoteUser.username); } 
好 了 ,和 运行 此 例 ， 浏 览 器 会 要 求 输入 验证 信息 ( 见 图 8-16 ) 。 


http://127.0.0.1:3000/ E. 
| € 127.0.0.1:3000 ni - X |ylieade 











To view this page, you must log in to this area 
on 127.0.0.1:3000: 
Authorization Required 


Your password will be sent unencrypted. 









Name: test 





图 8-16: 用 示例 的 验证 信息 填写 登录 对 话 框 


最 后 ， 通 过 命令 行 来 对 验证 进行 处 理 (不 安全 ) ， 如 图 8-17 所 示 。 
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8-17: 服务 器 将 用 户 输入 的 验证 信息 显示 在 命令 行 中 供 管理 员 处 理 
图 8-18 展 示 了 验证 通过 后 的 Web 站 点 。 


eoe http://127.0.0.1:3000/ 
[4 & | | @ 127.0.0.1:3000 





Welcome to the protected area, test 











图 8-18: 在 用 户 验证 通过 后 ， 请 求 也 验证 通过 了 


小 结 
本 章 介 绍 了 使 用 中 间 件 带 来 的 好 处 : 代码 能 以 此 为 构建 单元 进行 组 织 ， 并 且 能 够 获得 高 复 
用 性 Connects} mA ATE 它 为 构建 更 具 表 达 力 的 中 间 件 提供 了 基础 架构 。 
紧 接 着 ， 本 章 又 对 同一 个 例子 的 两 种 实现 一 单个 请 求 处 理 器 实现 以 及 拆 分 成 更 小 构建 单 
元 的 中 间 件 实现 ， 进 行 了 对 比 。 
最 后 ， 又 对 Connect 自 带 的 一 些 Web 应 用 开发 过 程 中 实用 的 中 间 件 一 一 进行 了 介绍 。 至 
， 你 应 当 已 经 学 会 了 如 何 自 定 义 中 间 件 ， 以 及 如 何 将 中 间 件 在 Node.js 模 块 系统 中 进行 重用 


CHAPTER 


Express 


鉴于 Connect 基 于 HTTP 模 块 提 供 了 开发 Web 应 用 常用 的 基础 功能 ，Express 基 于 Connect 为 
构建 整个 网 站 以 及 Web 应 用 提供 了 更 为 方便 的 API。 
纵 观 第 8 章 中 的 例子 ， 你 可 能 已 经 发 现 了 ， 绝 大 部 分 Web 服 务 器 和 浏览 右 之 间 交 互 的 任务 
都 是 通过 URL 和 method 来 完成 的 。 这 两 者 的 组 合 有 时 又 称 为 路 由 ， 通 过 Express 创 建 的 应 用 中 
的 一 个 基础 概念 。 
Express 基 于 Connect 构 建 而 成 ， 因 此 ， 它 也 保持 了 重用 中 间 件 来 完成 基础 任务 的 想法 。 这 
就 意味 着 ， 通 过 Express 的 API 方 便 地 构建 Web 应 用 的 同时 ， 又 不 失 构 建 于 HTTP 模 块 之 上 高 可 用 
中 间 件 的 生态 系统 。 


接 下 来 ， 我 们 通过 Express 构 建 一 个 查询 Twitter API 的 小 应 用 ， 来 了 解 Express 的 用 法 和 
功能 。 


一 个 小 型 Express 应 用 
应 用 虽 小 但 五 脏 俱 全 。 在 用 户 通 过 查询 关键 词 查询 “ 推 文 ”时 ， 需 要 返回 包含 查询 结果 
的 HTML 页面 。 另 外 ,我 们 这 次 不 在 请 求 处 理 器 中 采用 字符 串 拼接 的 方式 来 返回 HTML 页 面 内 
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容 ， 而 是 使 用 一 个 简单 的 模板 语言 来 实现 ， 并 将 逻辑 从 视图 层 分 离 到 控制 层 。 

那么 第 一 步 就 是 要 确保 将 所 需 的 模块 引入 进来 。 
创建 模块 

按照 惯例 ， 先 创建 一 个 backage .json 文 件 ， 这 次 需要 多 添加 两 个 额外 的 依赖 :ejs。 本 
例 中 要 使 用 的 模板 引擎 ， 以 及 superagent 来 简化 向 Twitter 发 送 HTTP 查 询 请 求 的 实现 。 





"name": "express-tweet" 
, "version": "0.0.1" 
, "dependencies": ( 
"express": "2.5.9" 
« "ejes". *0.4.2* 
, "superagent": "0.3.0" 
) 
) 


这 里 请 注意 ， 尽 管 本 例 中 我 们 使 用 的 是 Express 2， 但 代码 应 该 是 能 和 Express 3 完全 兼容 
的 (截止 本 书 撰写 期 间 Express 3 还 处 在 开发 阶段 ) 。 


定义 好 项 目的 元 数据 之 后 ， 接 下 来 创建 HTML 模 板 。 


HTML 

和 上 一 个 应 用 不 同 的 是 ， 为 了 避免 将 HTML 代 码 租 入 到 应 用 逻辑 (通常 叫做 处 理 器 或 者 
路 由 处 理 器 ) 中 ， 这 次 我 们 要 使 用 一 个 简单 的 模板 语言 来 处 理 。 模 板 语言 的 名 字 是 EJS CP 
(embedded ) 的 js ) ， 和 在 HTML 中 内 藤 PHP 类 似 。 


从 在 views/ 文 件 夹 中 创建 一 个 jndex .ejs 文 件 开 始 。 事实 上 ,模板 可 以 放 在 任何 一 个 地 
方 ， 不 过 考虑 到 本 例 的 项 目 结构 ， 我 们 就 将 其 单独 放 到 views 目 录 下 。 


首 个 模板 对 应 默认 的 路 由 路 径 〈 首页 ) 。 它 提供 一 个 人 口 让 用 户 提交 搜索 推 文 的 关键 字 : 


«hl»Twitter app</h1> 

<p>Please enter your search term:</p> 

<form action="/search" method="GET"> 
<input type="text" name="q"> 


<button>Search</button> 
</form> 


男 一 个 模板 search .ejs 用 于 展示 查询 结果 。 高 亮 查 询 关 键 词 并 将 查询 结果 逐一 显示 出 来 
( 如 果 有 的 话 ) ， 否 则 就 显示 一 条 消息 : 
«hl»Tweet results for <%= search $»«/hl» 


<% if (results.length) { %> 


<ul> 
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<% for (var i = 0; i < results.length; i++) { %> 
<li><%= results[i].text $» - <em><%= results[i].from user %></1li> 
<% ) 名 > 
«/ul» 
<% ) else ( %> 
«p»No results</p> 
<$ ) $5 


如 上 面 所 示 ， 我 们 将 JavaScript 代 码 嵌 在 <s 和 8#> EJS 标 签 中 。 男 外 ,我们 通过 在 <$ 之 后 加 
和 人 “=” 符 号 将 变量 值 打印 出 来 。 


SETUP 
我 们 现在 server .js 文件 中 引入 依赖 的 模块 : 


var express = require('express') 


引入 Express 之 后 ， 需 要 用 它 来 初始 化 Web 服 务 器 。 和 Connect 类 似 ，Express 提 供 了 一 个 
createServer 快 捷 方法 返回 一 个 Express HTTP 服 务 器 。 就 像 这 样 : 


var app = express.createServer () 

和 其 他 流行 的 Web 框 架 不 同 ，Express 并 不 要 求 任何 必要 的 配置 ， 也 不 对 文件 结构 有 特殊 的 
要 求 。 它 足够 灵活 ， 人 允许 你 对 每 一 个 单独 的 功能 点 进行 自 定义 。 

本 例 中 ， 我 们 需要 指定 使 用 的 模板 引擎 〈 这 样 就 不 需要 每 次 载 人 视图 时 都 去 引入 ) 以 及 视 
图 文件 (模板 ) 所 在 的 目录 。 刚 刚 介 绍 的 express .createServer 方 法 返回 的 HTTP 服 务 器 
自 带 配置 系统 。 我 们 可 以 通过 调用 该 对 象 上 的 set 方 法 来 修改 默认 的 配置 项 。 添 加 如 下 代码 : 


app.set('view engine’, ‘ejs'); 
app.set('views', _ dirname + '/views'); 
app.set('view options’, { layout: false }); 


第 三 个 view _ options 人 参数 所 定义 的 选项 ， 在 演 染 视图 时 ， 会 传递 到 每 个 模板 中 。 这 里 
layout 的 值 设置 为 false， 是 为 了 匹配 Express 3 中 的 默认 值 。 


要 获取 配置 信息 ， 可 以 调用 app . set 方法 并 传递 对 应 要 获取 配置 的 标志 。 比 如 ， 要 获取 
views 的 配置 信息 ， 可 以 通过 如 下 方式 : 


console.log(app.set('views')); 


接 下 来 ,我 们 会 使 用 Express 提 供 的 方法 来 定义 路 由 ， 关 于 路 由 的 有 关内 容 ， 我 们 其 实在 
第 7 章 和 第 8 章 就 已 经 接触 过 了 。 
定义 路 由 
通过 使 用 Express 来 定义 路 由 就 无 须 手 动 地 每 次 去 检查 method 和 url 属 性 ， 只 需 调用 
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Express 提 供 的 对 应 HTTP method 的 方法 ， 并 将 URL 和 对 应 的 处 理 中 间 件 传递 进去 就 可 以 了 。 


Express 支 持 的 方法 有 get、put、post、del、patch 以 及 head, 分 别 对 应 HTTP 的 
GET、PUT、POST、DELETE、PATCH 以 及 HEAD。 下 面 是 定义 路 由 的 例子 : 


app.get('/', function (req, res, next) {}); 
app.put('/post/:name', function (req, res, next) {}); 
app.post('/signup', function (req, res, next) {}); 
app.del('/user/:id', function (req, res, next) {}); 
app.patch('/user/:id', function (req, res, next) {}); 
app.head('/user/:id', function (req, res, next) {}); 


第 一 个 参数 是 路 由 地 址 ， 第 二 个 参数 是 路 由 处 理 程序 。 路 由 处 理 程序 就 和 中 间 件 一 样 。 


注意 了 ， 路 由 部 分 还 可 以 通过 特殊 格式 来 定义 变量 。 如 上 述 例 子 中 的 /user/ :idq， 哪 怕 id 
值 不 同 ， 路 由 也 能 匹配 到 : 如 /user/2、/user/3， 等 等 。 下 一 章 会 对 这 部 分 内 容 做 详细 介绍 。 


下 面 我 们 来 定义 首页 的 路 由 : 添加 如 下 代码 到 server .js 文件 中 : 


app.get('/', function (req, res) { 
res.render('index'); 
}); 


到 目前 为 止 ， 完 整 代 码 如 下 所 示 : 
/** 

* 模块 依赖 

*yl 

var express - require('express') 


, search = require('./search') 
/** 
* 创建 app 


wf 


var app = express.createServer(); 


/** 

* 配置 

wy 
app.set('view engine', 'ejs'); 
app.set('views', _ dirname + '/views'); 


app.set('view options', ( layout: false )); 
/** 
* 路 由 


app.get('/', function (req, res) { 
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res.render('index'); 


)); 


/** 

« 监听 

wy 
app.listen(3000) ; 


Express 为 response 对 象 提供 了 render 方 法 。 该 方法 完成 如 下 三 件 事 : 


1. 初始 化 模板 引擎 。 
2. 读 取 视 图 文件 并 将 其 传递 给 模板 引擎 。 
3. 获取 解析 后 的 HTML 页 面 并 作为 响应 发 送 给 客户 端 。 


由 于 在 前 一 步 中 将 ej s 指 定 为 视图 引擎 ， 因 此 无 须 显 式 地 指明 index.ejsT 了 。 
运行 之 后 结果 如 图 9-1 所 示 ( 别 忘 记 调 用 listen 方 法 ) 。 


eoe http://127.0.0.1:3000/ £e 





图 9-1: 路 由 处 理 器 / 泻 染 index 视 图 


第 二 个 路 由 中 ,我们 调用 一 个 名 为 search 的 方法 ( 将 在 另外 一 个 模块 中 定义 ) : 


app.get('/search', function (req, res, next) { 
search(req.query.q, function (err, tweets) { 
if (err) return next (err); 
res.render('search', { results: tweets, search: req.query.q }); 
M3; 
)); 


接着 ， 在 express 之 后 添加 对 search 模 块 的 依赖 : 


var express = require('express') 


, search = require('./search') 


这 里 要 注意 ， 如 果 search 方 法 回调 函数 中 接收 到 错误 对 象 ， 那 么 我 们 就 直接 把 它 传递 给 
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next。 后 面 章节 会 介绍 错误 处 理 的 相关 内 容 ， 到 时 你 就 能 明白 为 什么 要 这 么 做 了 ， 目 前 ,我 
们 就 假设 Express 会 将 错误 信息 通知 给 用 户 。 


这 个 路 由 处 理 器 中 ， 我 们 也 调用 了 render 方 法 ， 不 过 不 同 的 是 ， 这 次 我 们 传递 了 一 个 对 
象 作为 第 二 个 参数 。 该 对 象 的 内 容 会 暴露 给 视图 。 注 意 这 里 我 们 是 如 何 把 tweets 和 search 
传递 过 去 的 ， 这 两 个 变量 可 以 在 search .ejs 视 图 中 直接 使 用 。 这 类 对 象 称 为 本 地 变量 ， 因 为 
它 的 内 容 只 对 其 传递 的 视图 可 见 。 


查询 
查询 模块 暴露 一 个 简单 的 方法 提供 对 推 文 的 查询 ， 其 内 部 调用 了 Twitter 的 查询 API。 本 例 
中 ,我们 将 查询 模块 search .js 文件 和 server .js 文件 放 到 同一 目录 中 。 


上 述 调用 search 方 法 的 代码 中 ,传递 了 一 个 查询 关键 字 以 及 回调 函数 ， 回 调 函 数 接收 两 个 
参数 ， 其 一 是 错误 对 象 ( 如 果 有 的 话 ) ， 其 二 是 一 个 包含 了 查询 到 的 推 文 的 数组 。 


要 写 这 样 一 个 模块 ， 我 们 先 来 定义 依赖 的 模块 。 本 例 中 ， 只 需 用 到 superagent: 
var request = require('superagent') 


由 于 向 Twitter 的 Web 服 务 发 送 HTTP 请 求 是 本 例 中 重要 的 功能 ， 我 们 需要 确保 查询 模块 正 
确 地 进行 了 错误 处 理 。 


比如 ， 要 是 Twitter API 服 务 宕 机 了 ， 我 们 就 发 送 一 个 错误 对 象 ， 来 给 用 户 显 示 一 个 错误 页 
面 (如 : 显示 HTTP 错 误 状 态 码 500 ) 。 


jee 
* Search function. 


* @param {String} search query 
* @param {Function} callback 

* @api public 

SA 


mođule.exports = function search (query, fn) { 
request.get('http://search.twitter.com/search.json') 
.data(( q: query )) 
.end(function (res) ( 
if (res.body && Array.isArray(res.body.results)) ( 
return fn(null, res.body.results); 
} 
fn(new Error('Bad twitter response’) ; 
)); 
IE 


和 其 他 superagnet 例 子 类 似 ， 我 们 发 送 一 个 GET 请 求 ， 将 查询 关键 字 作 为 数据 字段 g 的 值 
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以 查询 字符 串 的 形式 发 送出 去 。 以 hello world 为 查询 关键 字 的 URL 类 似 http://search. 


twitter.com/search.json? q=hello+world, 


在 响应 处 理 程序 中 ,我 们 确保 请 求 发 送 成 功 并 且 完 全 符合 我 们 的 预期 。 相 比 查看 HTTP 响 
应 码 是 否 为 200， 我 们 采用 更 加 聪明 的 方式 : 直接 查看 响应 结果 是 否 包含 含有 推 文 内 容 的 数组 。 


第 7 章 中 我 们 就 介绍 过 ， 如 果 superagent 获 取 到 一 个 JSON 形 式 的 响应 消息 ， 它 会 自动 进行 解 
码 ， 并 将 解码 后 的 内 容 放 到 resbody 变 量 中 。 由 于 Twitter API 会 返回 一 个 JSON 对 象 ， 对 象 中 的 results 
字段 内 容 就 是 包含 了 推 文 的 数组 ， 因 此 ， 下 述 代 码 段 对 于 进行 错误 处 理 的 判断 来 说 足 侨 : 


if (res.body && Array.isArray(res.body.results)) { 
return fn(null, res.body.results) ; 


~ 


eae 并 通过 浏览 器 访问 http://localhost:3000 ( 见 图 9-2) ， 试 着 
输入 推 文 关键 字 ( 见 图 9-3 ) 。 


eoe http://127.0.0.1:3000/ P o 


Lala ] ©@ 127.0.0.1:3000 | 








图 9-2: 输入 查询 推 文 关键 字 并 提交 的 例子 


eo e. http://127.0.0.1: 3000/search?q=justin+ bieber Pal 
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成 功 ! 向 Twitter 查询 推 文 后 ， 我 们 获得 了 一 个 包含 推 文 的 数组 。 最 终 它 会 显示 在 根据 推 文 
数组 动态 生成 的 search .ejs 模 板 中 。 

HTML 页 面 由 Express 的 演 染 引擎 产生 ，/search 路 由 成 功 地 将 完整 的 页 面 显示 给 用 户 ， 
如 图 9-3 所 示 。 

在 这 个 简单 的 示例 后 ， 接 下 来 该 是 深入 研究 Express 特 性 的 时 候 了 ， 我 们 来 看 一 些 新 的 
功能 。 


设置 
Express 提 供 了 最 有 意思 的 特性 之 一 ， 同 时 也 是 对 任意 类 型 Web 应 用 都 不 可 或 缺 的 ， 就 是 对 
环境 设置 的 管理 能 力 。 


比如 ,在 生产 环境 下 ， 为 了 提高 性 能 ， 我 们 可 以 让 express 将 模板 缓存 起 来 ， 这 样 可 以 加 快 
响应 速度 。 然 而 ， 若 在 开发 模式 下 开启 这 个 功能 ， 每 次 对 模板 稍 做 改动 就 需要 重启 Node 服 务 
程序 才能 生效 。 


通过 如 下 方式 就 可 以 达到 让 Express 对 模板 进行 缓存 的 效果 : 


app.configure('production', function () ( 
app.enable('view cache'); 


)); 
在 上 述 代码 中 ，app .enable 就 等 同 于 此 前 例子 中 为 了 配置 views config 标 志 所 用 到 的 
app.set, 


app.set('view cache', true); 


要 查看 配置 标志 是 否 启用 ， 也 可 以 调用 app .enabled。 对 应 的 还 有 app .disable 和 
app.dqisabled 方 法 。 

当 环 境 变量 NODE_ENV 设 置 为 production 时 ， 我 们 在 app.configure 定 义 的 对 应 的 回调 
函数 就 会 被 执行 。 

要 测试 上 述 人 代码， 运行 如 下 命令 : 

$ NODE_ENV=production node server 


要 是 NODE_ENV 没 有 设置 ， 则 默认 会 调用 development 的 配置 : 


app.configure('development', function () { 
// gets called in the absence of NODE_ENV too! 
}); 


下 面 还 有 一 些 内 置 的 实用 设置 : 
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© 大 小 写 敏 感 的 路 由 : 启用 大 小 写 敏 感 的 路 由 。 默 认 情 况 下 ， 当 定义 如 下 路 由 : 
app.get('/my/route', function (req, res) () 
Express 能 匹配 到 /my/route 和 /MY/ROUTE。 开 启 之 后 ， 路 由 只 会 匹配 定义 的 路 由 ， 
上 述 例 子 中 就 只 会 匹配 /my/route。 

= 严格 路 由 : 启用 后 ， 最 后 的 斜 杠 就 不 会 自动 忽略 。 什 么 意思 呢 ? 比如 ， 此 前 例子 中 
能 匹配 /my/route 和 /my/route/， 而 一 旦 开启 严格 路 由 模式 ， 只 会 匹配 到 /my/ 
route， 因 为 路 由 就 是 这 样 在 app.set 中 定义 的 。 

* jsonp 回 调 : 启用 res .send() / res.json() 对 jsonp 的 支持 。 JSONP 是 一 项 解决 跨 
域 JSON 请 求 的 技术 ， 它 将 响应 结果 包 庄 在 一 个 用 户 指 定 的 回调 函数 中 。 


«= 当 有 JSONP 请 求 时 ， 其 URL 类 似 这 样 : /my/route?callback=myCallback, 
Express 会 自动 检测 callback 参 数 ， 并 将 相应 结果 包 囊 在 mycallback 文 本 中 。 要 启用 
该 功能 ， 可 以 调用 app.enable('jsonpP callback')。 这 里 要 注意 ， 这 只 作用 于 
res.sendfllres.json, 后 面 的 章节 会 有 相关 介绍 。 


模板 引擎 
要 像 此 前 例子 那样 使 用 ejs， 必 须 完成 以 下 两 个 步 又 : 


1. 通过 NPM 安 装 ej s 模 块 。 
2， 声 明 view engine 为 ejs。 


如 下 的 其 他 模板 引擎 也 可 以 在 Express 中 使 用 : 

* Haml 

* Jade 

* CoffeeKup 

* jQuery Templates for node 

Express 会 试 着 以 模板 文件 扩展 名 或 者 以 配置 的 view engine 的 值 为 名 去 调用 require 方 法 。 
比如 ， 可 以 调用 : 

res.render('index.html') 

这 时 ，Express 会 尝试 着 去 require htm1 引 擎 。 找 不 到 该 引擎 ， 就 会 报错 。 

也 可 以 通过 app.register API 将 扩展 名 匹配 到 指定 的 模板 引擎 。 比 如 ， 通 过 如 下 方式 
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就 可 以 将 html 扩 展 名 匹配 到 jade 模 板 引擎 : ， 

app.register('.html', require('jade')); 

Jade 是 最 流行 的 模板 语言 之 一 ， 绝 对 值得 一 学 。 要 想 了 解 更 多 关于 Jade 的 内 容 可 以 访问 其 
官方 网 站 http://jade-lang.org。 


音 误 处 理 
在 Node 中 ， 将 错误 对 象 作为 非 阻 塞 VO 回 调 函 数 的 第 一 个 参数 是 很 常见 的 。 在 本 章 的 例子 
中 ， 我 们 也 有 可 能 在 调用 Twitter API 进 行 查询 时 接收 到 错误 对 象 。 


面 对 这 种 情况 ， 在 Express 中 常规 的 做 法 就 是 将 该 错误 对 象 传递 给 next 函 数 。 默 认 情 况 下 ， 
Express 会 展示 一 个 错误 页 面 并 发 送 500 状 态 码 。 


绝 大 多 数 Web 应 用 都 会 自 定义 错误 页 面 ， 或 者 甚至 自 建 一 套 后 台 的 错误 处 理 机 制 。 
我 们 可 以 通过 app.error 方 法 定义 一 个 特殊 的 错误 处 理 器 作为 错误 处 理 的 中 间 件 : 


app.error(function (err, req, res, next) { 
if ('Bad twitter response' == err.message) { 
res.render('twitter-error'); 
) else ( 
next (); 
} 
}); 


注意 在 上 述 代 码 中 ， 通 过 检测 错误 消息 内 容 来 判断 是 否 要 对 错误 进行 处 理 ， 要 是 检测 结果 
不 匹配 就 直接 调用 next。 

还 可 以 设置 多 个 .erroz 处 理 器 来 执行 不 同 的 处 理 。 比 如 ， 最 后 一 个 错误 处 理 器 就 可 以 发 
送 500 Internal Server Error 并 展示 一 个 通用 的 错误 页 面 。 


app.error (function (err, req, res) { 
res.render('error', { status: 500 }); 
); 


当 调用 next 并 且 对 应 的 处 理 器 无 法 找到 时 ， 默 认 的 Express 错 误 处 理 器 就 会 触发 。 
快捷 方法 

Express 为 Node 中 的 Request 和 Response 对 象 提供 了 一 系列 扩展 来 简化 开发 。 

Request 对 象 上 的 扩展 如 下 。 


1 PEATE: Express 3.x 中 需要 使 用 app.engine 方 法 。 
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* header: 此 扩展 能 够 让 程序 以 函数 的 方式 获取 头 信息 ， 并 且 还 是 大 小 写 不 敏感 的 。 


req.header('Host') 
reg.header('host') 


* accepts: 此 扩展 会 分 析 请 求 中 的 Accept 头 信息 ， 并 根据 提供 的 值 返 回 true 或 者 


false, 


req.accepts ('html') 
req.accepts ('text/html') 


* is; 此 扩展 和 accepts 类 似 ， 但 它 检查 Content-Type 头 信息 。 


reg.is('json') 
req.is('text/html') 


Response 对 象 上 的 扩展 如 下 。 
* header; 此 扩展 接收 一 个 参数 来 检查 对 应 的 头 信息 是 否 已 经 在 response 上 设置 了 。 


res.header('content-type') 
或 设置 header 的 两 个 参数 : 


res.header('content-type', 'application/json') 


= render; 对 render 相 信 你 已 经 了 解 不 少 了 。 不 过 ， 在 此 前 的 例子 中 ， 你 也 许 注意 到 
了 我 们 传递 了 status 值 。 这 是 一 个 特殊 的 类 型 设置 了 它 就 等 于 为 response 响 应 对 象 
设置 了 状态 码 。 

* 除 此 之 外 ， 还 可 以 提供 第 三 个 参数 给 render 方 法 来 获取 HTML 内 容 而 不 是 直接 将 
其 作为 响应 消息 自动 传递 出 去 。 


res.render('template', function (err, html) { 
// 处 理 收 到 的 html 
FAF 


= send: 此 扩展 很 奇特 。 它 会 根据 提供 参数 的 类 型 执行 响应 的 行为 。 
* Number: 发 送 状态 码 。 
res.send(500); 
* String: 发 送 HTML 内容 。 
res.send('<p>html</p>'); 
* Object/Array: 序列 化 成 JSON 对 象 ， 并 设置 相应 的 Content-Type 头 信息 。 


res.send({ hello: 'world' )); res.send([1,2,3]); 
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= json: 此 扩展 在 绝 大 多 数 场景 下 和 send 类 似 。 只 是 它 会 显 式 地 将 内 容 作为 JSON 对 象 
发 送 。 
res.json(5); 


在 发 送 值 类 型 未 知 的 情况 下 可 以 使 用 此 方法 。res .send 会 判断 发 送 值 的 类 型 ， 并且 依 据 
判断 结果 来 选择 是 否 调 用 JSON .stringify 方 法 。 如 果 是 数字 类 型 ， 那 么 会 认为 发 送 的 是 状 
态 码 ， 并 直接 结束 响应 。 而 res .json 会 把 数字 类 型 也 进行 JSON. stringify 转 换 。 
由 于 绝 大 部 分 情况 下 我 们 会 对 发 送 对 象 进行 编码 ， 所 以 ，res . send 还 是 很 不 错 的 选择 。 
EEDS * redirect; redirect 等 效 于 发 送 302 ( 暂时 移 除 ) 状态 码 以 及 Location 头 信息 。 如 下 所 
IRo 


res.redirect('/some/other/url') 


就 等 效 于 : 


res.header('Location', '/some/other/url'); 


res.send (302); 
上 述 代 码 在 Node.js 内 部 其 实 是 这 样 处 理 的 : 
res.writeHead(302, { 'Location': '/some/other/url' }); 

* redirect 还 可 以 接收 自 定义 的 状态 码 作 为 第 二 个 参数 。 假 设 你 不 想 发 送 302 而 是 发 送 
表示 永久 性 移 除 的 301 状 态 码 ， 可 以 采取 如 下 方式 。 
res.redirect('/some/other/url', 301) 

* sendfile; 此 扩展 和 Connect 中 的 static 中 间 件 类 似 ， 不 同 之 处 在 于 它 用 于 单个 文件 。 
res.sendfile('image.jpg') 

路 由 曾 在 我 们 的 示例 应 用 中 有 所 应 用 ， 事 实 上 ， 路 由 还 有 很 多 内 容 有 待 我 们 了 解 ， 它 们 对 

大 型 Web 应 用 都 非常 有 帮助 。 


路 由 
在 定义 路 由 时 ， 可 以 使 用 自 定义 参数 : 


app.get('/post/:name', function () { 
AP x pea 
)) 


上 述 代码 中 ，name 变 量 值 会 注 人 到 req .params 对 象 上 。 比 如 ， 当 通过 浏览 器 访问 '/ 
post/hello-world' 时 ，req .params 对 象 会 变 为 如 下 形式 : 
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app.get('/post/:name', function () { 
// req.params.name == "hello-world" 


}) 
还 可 以 通过 在 变量 后 添加 问号 ( ? ) 来 表示 该 变量 是 可 选 的 。 在 此 前 的 路 由 示例 中 ， 要 是 
通过 浏览 器 访问 /post ， 那 么 该 路 由 是 不 会 匹配 到 的 。 要 匹配 到 可 以 采用 如 下 方式 : 


app.get('/post/:name?', function (req, res, next) { 
// this will match for /post and /post/a-post-here 
}) 


像 这 样 定义 了 参数 的 路 由 ， 内 部 会 当 正则 表达 式 处 理 。 也 就 是 说 ， 定 义 路 由 时 也 可 以 直接 
使 用 RegExp 对 象 。 比 如 ， 只 想 匹 配 字母 、 数 字 以 及 中 划 线 的 话 ， 可 以 这 样 : 


app.get(/^\/post\/([a-z\d\-]*)/, function (req, res, next) { 
// req.params contains the matches set by the RegExp capture groups 
}) 


和 中 间 件 一 样 ， 在 路 由 处 理 程序 中 也 可 以 使 用 next。 即 使 当 一 个 路 由 匹配 并 得 到 处 理 ， 
还 是 可 以 强制 Express 去 继续 匹配 其 他 路 由 的 。 


比如 ， 让 路 由 只 接受 以 'h ' 开 头 的 参数 : 


app.get('/post/:name', function (req, res, next) { 
if ('h' != req.params.name[0]) return next(); 
/V «43 

)): 


就 是 因为 Express 提 供 了 灵活 的 路 由 ， 才 能 实现 像 上 述 这 样 的 处 理 代码 来 解决 多 变 的 情 
况 。 

举例 来 说 ， 许 多 Web 应 用 允许 如 /home 、/about 这 样 的 路 由 ,但 它们 同时 又 希望 能 够 让 
动态 的 内 容 也 能 有 永久 的 URL。 


在 定义 好 所 有 的 路 由 之 后 ， 可 以 再 定义 一 个 路 由 来 获取 用 户 名 ， 并 进行 数据 库 调 用 。 如 果 
该 用 户 未 能 找到 ， 就 调用 next 并 发 送 404， 和 否则 就 泻 染 该 用 户 个 人 页 面 。 


app.get('/home', function (req, res) { 
AD owes 
)): 


app.get('/:username', function (req, res, next) { 
// if you got here, no prior application routes matched 
getUser(req.params.username, function (err, user) ( 


if (err) return next(err); 


if (exists) ( 
res.render('profile') 


) else ( 
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next (); 
} 
}); 
3): 


如 你 所 知 ，Express 也 沿袭 了 中 间 件 的 概念 。 下 面 我 们 就 来 深入 了 解 一 下 。 


中 间 件 
由 于 Express 是 构建 于 Connect 之 上 的 ， 所 以 ， 当 创建 Express 服 务 器 时 可 以 使 用 Connect 兼 容 
的 中 间 件 。 比 如 ， 要 托管 images/ 目 录 下 的 图 片 ， 就 可 以 像 这 样 使 用 static 中 间 件 : 


app.use(express.static(__dirname + '/images')); 


或 者 ， 要 想 使 用 connect 的 session， 也 很 容易 ， 像 这 样 就 可 以 了 : 


app.use(express.cookieParser()); 


app.use(express.session()); 


注意 了 ， 在 引入 了 Express 之 后 就 可 以 直接 使 用 Connect 的 中 间 件 了 。 不 需要 require 
('connect ' ) 或 者 把 connect 作 为 项 目 依 赖 添 加 到 package .json 文 件 中 。 


中 间 件 是 易 理解 的 。 
更 有 意思 的 是 ， 和 全 局 中 间 件 〈 针 对 每 个 请 求 ) 不 同 ，Express 还 允许 只 在 特定 匹配 到 的 
路 由 中 才 使 用 中 间 件 。 


想象 一 下 这 样 一 个 场景 : 你 需要 检查 用 户 是 否 已 经 登录 ， 并 且 这 部 分 检查 只 在 特定 受 保护 
的 路 由 中 进行 。 这 个 时 候 ， 就 可 以 定义 一 个 secure 中 间 件 ， 判 断 若 req.session.1logged_ 
in 不 为 true 时 就 发 送 403 Not Authorized Ads, 


function secure (req, res, next) { 
if (!req.session.logged_in) { 
return res.send(403); 


) 


next(); 


) 
然后 ， 将 它 应 用 到 对 应 的 路 由 中 : 


app.get('/home', function () { 
// accessible to everyone 
)); 


app.get('/financials', secure, function () { 
// secure! 


)); 


app.get('/about', function () ( 


// accessible to everyone 
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); 


app.get('/roadmap', secure, function () ( 
// secure! 
); 


还 可 以 像 这 样 为 路 由 定义 多 个 中 间 件 : 
''app.post('/route', a, b, c, function () { )); 


有 的 时 候 ， 在 中 间 件 中 调用 next 就 可 以 跳 过 该 路 由 的 其 他 中 间 件 ， 这 样 Express 就 会 紧 接 
着 在 下 一 个 路 由 中 做 相应 处 理 。 


比如 ， 若 相 比 发 送 403 ， 你 更 希望 Express 去 检查 其 他 的 路 由 ， 那 么 就 可 以 采用 如 下 方式 来 
实现 : 


function secure (req, res, next) { 
if (!req.session.logged_in) { 
return next ('route'); 


} 


next (); 


} 
通过 调用 next ( 'zoute') ， 就 能 确保 当前 路 由 会 被 跳 过 。 


随 着 项 目 规模 的 扩大 ， 路 由 和 中 间 件 的 数量 也 会 越 来 越 多 ， 因 此 ， 如 何 更 好 地 组 织 代码 就 
变 得 非常 有 用 。 下 面 我 们 就 来 介绍 这 部 分 的 内 容 。 


代码 组 织 策略 
对 于 任意 一 个 Node.js 应 用 ( 包括 Express Web 应 用 ) 来 说 ， 第 一 条 准则 都 是 模块 化 。Node. 
js 通过 提供 一 个 简单 的 require API 来 提供 一 个 强大 的 代码 组 织 策略 。 


比如 ， 一 个 应 用 包含 三 块 独立 的 内 容 : /blog、/pages 以 及 /tags。 每 块 都 包含 各 自 的 
路 由 。 例 如 : /blog/search、/pages/list 以 及 tagst/cloud。 


好 的 代码 组 织 方式 应 当 是 维护 一 个 server.js 文 件 ， 该 文件 中 包含 了 路 由 表 ， 同 时 将 每 一 
部 分 的 路 由 处 理 器 都 通过 模块 化 的 方式 来 引入 ， 如 blog.js、pages.js 以 及 tags.js。 首 
先 ， 定 义 依赖 的 模块 并 初始 化 app、 引 入 中 间 件 等 : 


var express = require('express') 
, blog = require('./blog') 
, Pages = require('./pages') 
, tags = require('./tags') 


// initialize app 
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var app = express.createServer(); 


// here you would include middleware, settings, etc 


接着 定义 之 前 提 到 的 路 由 表 ， 这 里 简单 地 将 所 有 的 路 由 信息 都 罗列 出 来 放 在 一 个 地 方 : 


// blog routes 

app.get('/blog', blog.home) ; 
app.get('/blog/search', blog.search) ; 
app.post('/blog/create', blog.create) ; 


// pages routes 
app.get('/pages', pages.home) ; 
app.get('/pages/list', pages.list); 


// tags routes 


app.get('/tags', tags.home) ; 
app.get('/tags/search', tags.search); 


然后 ， 针 对 每 个 模块 需要 使 用 exports 函 数 。 以 blog .js 为 例 : 


exports.home = function (req, res, next) { 
// home 
}; 


exports.search = function (req, res, next) { 
// search functionality 
} H 


模块 化 提供 了 很 强大 的 扩展 性 。 上 述 代码 还 可 以 根据 http 方 法 进行 进一步 扩展 。 例 如 : 


exports.get = {}; 

exports.get.home = function (req, res, next) ()) 
exports.post = {}; 

exports.post.create = function (req, res, next) {}) 


另外 一 种 对 应 用 进行 解 耦 的 方式 叫做 app 挂 载 。 你 可 以 将 整个 Express app 作 为 一 个 模块 


(模块 中 依然 可 以 使 用 NPM 模 块 ) ， 并 将 其 挂 载 到 现 有 的 应 用 中 ， 这 样 就 能 够 让 路 由 无 颖 对 
接 起 来 。 


考虑 这 样 一 个 博客 的 应 用 。 你 可 以 将 一 个 博客 相关 的 路 由 都 通过 /来 定义 ，/categories 


以 及 /search， 然 后 将 其 以 blog .js 文件 暴露 出 来 : 


var app = module.exports = express.createServer(); 
app.get('/', function (req, res, next) {}); 
app.get('/categories', function (req, res, next) {}); 
app.get('/search', function (req, res, next) {}); 


注意 ， 上 述 路 由 都 是 通过 绝对 路 径 来 定义 的 ， 不 包含 任何 前 级 。 接 着 ， 在 主 程序 中 ， 要 做 


的 就 是 将 其 引入 并 传递 给 app .use 方 法 : 
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app.use(require('./blog')); 


这 样 一 来 ， 所 有 博客 相关 的 路 由 就 都 可 以 使 用 了 。 除 此 之 外 ， 你 还 可 以 为 它们 定义 一 个 前 


app.use ('/blog', require('./blog')); 


现在 ，/blog/、/blog/categories 以 及 /blog/search 以 后 都 可 以 直接 给 其 他 
express 应 用 使 用 ， 并 且 它 自身 拥有 完全 独立 的 依赖 、 中 间 件 、 配 置 ， 等 等 。 


小 结 
本 章 介绍 了 如 何 使 用 最 流行 的 Node.js Web 框 架 Express。 


使 用 Express 最 大 的 益处 就 在 于 ， 它 简洁 、 配 置 少 但 却 又 不 失灵 活 ， 同 时 它 和 Connect 一 样 
构建 于 测试 全 面 、 抽 象 简洁 的 基础 之 上 。 


和 其 他 Web 框 架 或 者 类 库 不 同 ，Express 非 常 容易 进行 模块 化 来 满足 不 同 的 需求 、 结 构 以 及 
模式 。 本 章 介 绍 了 如 何 使 用 Express 以 最 少 的 代码 来 构建 首 个 示例 应 用 ， 就 像 Node.js Hello World 
程序 那样 。 


事实 上 ， 你 或 许 已 经 注意 到 了 ， 与 重新 在 Node.js core API 基 础 上 构建 一 套 新 的 方式 不 同 ， 
Express 尝 试 与 core API 靠 拢 ， 并 扩展 它 。 这 就 是 路 由 处 理 器 可 以 直接 接收 原生 的 Node request 
和 response 对 象 的 原因 ， 就 像 我 们 在 首 个 HTTP 服 务 器 应 用 中 那样 。 本 章 介 绍 了 一 些 Express 实 
用 的 扩展 ， 比 如 ， 如 何 使 用 res . send 来 以 JSON 的 形式 进行 响应 等 。 


本 章 最 后 介绍 了 如 何 将 不 同 功能 的 代码 组 织 起 来 创建 一 个 可 维护 的 应 用 。 介 绍 了 最 好 的 方 
式 就 是 通过 Node.js 核 心 的 API: 通过 使 用 require 就 是 其 中 一 个 最 强大 的 工具 ， 来 进行 更 上 层 
的 代码 组 织 。 


151 


CHAPTER 


WebSocket 


目前 ， 绝 大 部 分 网 站 和 Web 应 用 开发 者 都 习惯 了 通过 发 送 HTTP 请 求 来 和 服务 器 进行 通 
信 ， 随 后 接收 服务 器 的 HTTP 响 应 。 
正如 在 上 一 章 中 看 到 的 那样 ， 通 过 指定 URL、Content-Type 以 及 设置 其 他 属性 来 获取 
资源 的 模型 是 最 常见 的 ， 也 是 万 维 网 中 最 常见 的 方式 。Web 生 来 就 是 用 以 传递 互相 关联 的 文档 
的 。URL 之 所 以 含有 路 径 信息 是 因为 文档 通常 在 文件 系统 中 是 有 层次 结构 的 ， 并且， 每 一 层 的 
结构 都 包含 了 对 超 链接 的 索引 。 
如 下 述 例子 : 


GET /animals/index.html 
GET /animals/mammals/index.html 
GET /animals/mammals/ferrets.html 


然而 ， 随 着 时 间 的 推移 ，Web 变 得 越 来 越 注重 用 户 体验 。 如 今 ， 特 别 是 随 着 HTML5 以 及 
相关 工具 的 诞生 ， 传 统 的 那 种 每 次 需要 用 户 点 击 之 后 才能 获取 文档 的 方式 正在 逐步 退出 历史 舞 
台 。 现 在 已 经 可 以 创建 出 如 游戏 、 文 本 编辑 器 等 这 种 非常 酷 的 Web 应 用 了 ， 完 全 可 以 取代 了 传 
统 的 桌面 应 用 。 


Ajax 
Web 2.0 标 志 着 Web 应 用 的 崛起 。 其 中 一 个 关键 因素 就 是 Ajax， 其 具体 表现 在 于 提高 了 用 
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户 体验 ， 这 背后 重要 的 原因 就 是 : 用 户 再 也 不 用 每 次 都 通过 交互 操作 才能 从 服务 器 端 获取 新 的 
HTML 文档 。 


比如 ， 要 想 在 社交 应 用 中 更 新 个 人 信息 ， 发 送 一 个 异步 的 POST 请 求 ， 随 后 会 收 到 一 个 更 
新 成 功 的 返回 消息 。 接 着 ， 使 用 一 个 简单 易 用 的 JavaScript 框 架 ， 更 新 视图 以 展现 用 户 行为 结 
果 即 可 。 

再 比如 ， 当 用 户 点 击 一 张 表 中 的 移 除 按钮 时 ， 就 可 以 发 送 DELETE 请 求 ， 并 移 除 该 行 
(«tr») 元 素 即 可 ， 无 须 刷 新 浏览 器 ， 也 无 须 再 去 获取 许多 不 必要 的 数据 、 图 片 、 脚 本 以 及 
样式 文件 以 及 重新 泻 染 整个 页 面 。 


Ajax 之 所 以 重要 ， 从 本 质 上 来 说 ， 它 避免 了 许多 原本 需要 在 Web 应 用 中 处 理 的 数据 传递 和 
泻 染 的 开销 。 


然而 ， 现 在 许多 应 用 通过 传统 的 HTTP 请 求 + 响应 模型 的 方式 来 发 送 和 接收 数据 依然 会 造 
成 很 大 的 开销 。 就 拿 本 章 中 要 构建 的 应 用 来 说 ， 我 们 要 想 实时 地 获取 每 位 网 站 访问 者 当前 鼠标 
的 位 置 。 那 么 每 次 当 用 户 移动 鼠标 时 ， 我 们 都 要 将 坐标 信息 发 送 给 服务 器 。 


假设 使 用 jQuery 来 发 送 Ajax 请 求 。 第 一 个 想到 的 办 法 就 是 : 每 次 mousemove 事 件 触发 
时 ， 就 通过 $ .Post 向 服务 器 发 送 一 个 POST 请 求 ， 如 下 所 示 : 
$(document) .mousemove(function (ev) { 
$.post('/position', { x: ev.clientX, y: ev.clientY }); 
)); 


上 述 代码 尽管 看 起 来 很 直观 ， 但 是 有 个 根本 性 的 问题 : 无 法 控制 服务 器 接收 请 求 的 先后 
顺序 。 


当 执 行 代 码 发 出 请 求 时 ， 浏 览 器 会 使 用 可 用 的 socket 来 进行 数据 发 送 ， 为 了 提高 性 能 ， 
浏览 器 会 和 服务 器 之 间 建 立 多 个 socket 通 道 。 举 例 来 说 ， 在 下 载 图 片 的 时 候 ， 还 是 可 以 同时 
发 送 Ajax 请 求 。 要 是 浏览 器 只 有 一 个 socket 通 道 ， 那 么 ， 网 站 泻 染 和 使 用 都 会 非常 慢 。 


若 三 个 请 求 分 别 通过 三 个 不 同 的 socket 通 道 发 送 ， 就 无 法 保证 服务 器 端 接收 的 顺序 了 。 所 
以 ， 要 解决 这 个 问题 ， 我 们 需要 调整 代码 ， 在 服务 器 接收 到 一 个 请 求 后 再 接着 发 送 第 二 个 请 
求 ， 这 样 就 能 保证 接收 的 顺序 了 : 


var sending = false; 


$(document) .mousemove(function (ev) { 
if (sending) return; 
sending = true; 
$.post('/position', { x: ev.clientX, y: ev.clientY }, function () { 
sending = false; 
3); 
)) ; 


作为 例子 ， 下 面 显示 了 Firefox 中 TCP 传 输 消息 的 内 容 : 
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esteem aa mpc ams 
Request 


POST / HTTP/1.1 

Host: localhost:3000 

User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.7; rv:8.0.1) Gecko/20100101 
Firefox/8.0.1 

Accept: */* 

Accept-Language: en-us,en;q=0.5 

Accept-Encoding: gzip, deflate 

Accept-Charset: ISO-8859-1,utf-8;q-0.7,*;q-0.7 

Content-Type: application/x-www-form-urlencoded; charset-UTF-8 

X-Requested-With: XMLHttpRequest 

Referer: http://localhost:3000/ 

Content-Length: 7 

Pragma: no-cache 

Cache-Control: no-cache 


x=6&y=7 








Response 


HTTP/1.1 200 OK 
Content-Type: text/plain 
Content-Length: 2 
Connection: keep-alive 


OK 


如 上 述 例子 所 示 ， 除 了 一 小 段 数据 ， 还 包含 了 很 多 的 文本 内 容 。 对 于 上 述 例子 而 言 ， 很 多 
不 需要 的 头 信 息 依 然 被 发 送 了 出 去 ， 这 些 头 信息 的 数据 量 远 远 超过 了 真正 要 发 送 数据 本 身 的 大 
Vo 
尽管 可 以 移 除 其 中 一 些 头 信息 ， 但 是 对 于 上 述 例子 来 说 ， 我 们 真 的 需要 响应 消息 吗 ? 在 发 
送 一 些 像 鼠标 位 置 这 样 无 关 紧 要 的 信息 时 ， 其 实 根本 不 需要 等 到 响应 返回 后 再 接着 发 送 更 多 的 
消息 。 
对 于 这 类 Web 应 用 来 说 ， 理 想 解 决 方案 得 从 TCP 而 非 H8TTP 入 手 ( 就 像 第 6 章 中 的 聊天 程序 
那样 ) 。 理 想 状 态 下， 我 们 更 希望 直接 将 数据 ， 另 外 附加 最 小 的 消息 窗口 ( 就 是 与 真正 发 送 的 
数据 包 庄 在 一 起 的 数据 ) 通过 socket 发 送 。 
拿 telnet 举 例 的 话 ， 我 们 就 希望 浏览 器 可 以 发 送 如 下 面 这 样 的 数据 : 


x=6&y=7 \n 
x=10&y=15 \n 


归功 于 HTMLS， 现 在 我 们 有 了 这 样 的 解决 方案 : WebSocket。WebSocket 是 Web 下 的 TCP， 
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个 底层 的 双向 socket， 人 允许 用 户 对 消息 传递 进行 控制 。 


HTML5 WebSocket 


每 次 提 到 WebSocket 的 时 候 ， 其 实 是 在 讲 两 部 分 内 容 : 一 部 分 是 浏览 器 实现 的 WebSocket 


API， 另 一 部 分 是 服务 器 端 实现 的 WebSocket 协 议 。 这 两 部 分 是 随 着 HTML5 的 推动 一 起 被 设计 
和 开发 的 ， 但 是 两 者 都 没有 成 为 HTML5 标 准 的 一 部 分 。 前 者 被 W3C 标 准 化 了 ， 而 后 者 被 IETF 
标准 化 为 RFC 6455。 

浏览 器 端 实现 的 API 如 下 : 


var ws = new WebSocket('ws://host/path'); 

ws.onopen = function () { 
ws.send('data'); 

) 

ws.onclose - function () () 

ws.ondata - function (ev) ( 
alert(ev.data); 

) 


上 述 简单 的 API 不 禁 让 我 们 想起 第 6 章 中 写 过 的 TCP 客 户 端 。 和 XMLHttpRequest 


(Ajax) 不 同 ， 它 并 非 面向 请 求 和 响应 ， 而 是 可 以 直接 通过 send 方 法 进行 消息 传递 。 通 过 
data 事 件 ， 发 送 和 接收 UTF-8 或 者 二 进 制 编码 的 消息 都 非常 简单 ， 男 外 ， 通 过 open 和 close 
事件 能 够 获知 连接 打开 和 关闭 的 状态 。 


后 ， 


首先 ， 连 接 必 须 通过 握手 来 建立 。 握 手 方面 和 普通 的 HTTP 请 求 类 似 ， 但 在 服务 器 端 响应 
客户 端 和 服务 器 端 收发 数据 时 ， 数 据 本 身 之 外 的 信息 非常 少 : 


Request 


GET /ws HTTP/1.1 

Host: example.com 

Upgrade: websocket 

Connection: Upgrade 

Sec-WebSocket-Version: 6 
Sec-WebSocket-Origin: http://pmx 
Sec-WebSocket-Extensions: deflate-stream 
Sec-WebSocket-Key: x3JJHMbDL1EzLkh9GBhXDw-- 





Response 


HTTP/1.1 101 Switching Protocols 

Upgrade: websocket 

Connection: Upgrade 

Sec-WebSocket-Accept: HSmrc0sM1YUkAGmm50PpG2HaGWk= 
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WebSocket 还 是 建立 在 HTTP 之 上 的 ， 也 就 说 ， 对 于 现 有 的 服务 器 来 说 ， 实 现 WebSocket 协 
议 非 常 容易 。 它 和 HTTP 之 间 主 要 的 区 别 就 是 ， 握 手 完成 后 ， 客 户 端 和 服务 器 端 就 建立 了 类 似 


TCP socket 这 样 的 通道 。 
为 了 更 好 地 理解 这 部 分 内 容 ， 我 们 来 写 个 示例 应 用 。 


一 个 ECHO 示 例 
第 一 个 示例 包含 一 个 服务 器 和 一 个 客户 端 ， 主 要 完成 互相 之 间 消 息 的 交换 并 输出 接收 的 消 
息 内 容 。 当 客户 端 发 送 消息 时 ， 记 录 相 应 的 时 间 ， 用 于 计算 服务 器 处 理 响 应 花费 了 多 长 时 间 。 


初始 化 项 目 
本 例 中 ， 我 们 将 使 用 我 在 LearnBoost 工 作 时 开发 的 websocket .io 模块 。 


这 里 有 一 点 非常 重要 : websocket .io 仅 处 理 WebSocket 相 关 的 请 求 。 其 他 请 求 仍 由 
你 的 网 站 或 者 应 用 的 常规 Web 服 务 器 来 处 理 ， 这 就 是 我 们 在 Package.json 文 件 中 加 入 对 
express 的 依赖 ' 的 原因 : 


1 译 者 注 : 截止 译 者 翻译 期 间 ， 本 章 示 例 在 最 新 稳定 版 node.js v0.10.x 下 运行 会 有 错误 抛 出 。 具 体 原 因 是 websocket.io 
中 代码 书写 有 问题 ， 要 解决 需要 将 websocket.io/lib/hybi-16.js 文 件 中 如 下 左 侧 部 分 的 代码 中 的 ,on ('xxx', fn), 均 


改 为 .onxxx = fn 的 形式 ， 如 下 右 侧 所 示 : 


this.parser : this.parser.ontext = function (packet) { 
.on('text', function (packet) { self.onMessage (packet) ; 
}; 
self.onMessage (packet); 
) this.parser.onbinary = function (packet) 
.on('binary', function (packet) { 
self.onMessage (packet) ; 


self.onMessage (packet) ; : HE 

)) 

.on('ping', function. () { : this.parser.onping - function () ( 
i // version 8 ping => pong 

// version 8 ping => pong i try { 

try ( 


self.socket.write('Nu008aNu0000'); 


self.socket.write('Nu008aNu0000'); 
catch (e) ( 


catch (e) { 


self.end(); : self.end(); 

return; i return; 

} }e 

-on('close', function () { this.parser.onclose = function () { 
: self.end(); 

self.end(); A HH 

}) 

.on('error', function (reason) { : this.parser.onerror = function (reason) { 
| self.log.warn(self.name + 'parser error:' 

self.log.warn(self.name + 'parser error:' | + reason); 

+ reason); i self.end(); 


self.end(); H he 
) 
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"name": "ws-echo" 
, "version": "0.0.1" 
, "dependencies": ( 
"express": "2.5.1" 
, "websocket.io": "0.1.6" 


) 
服务 器 的 处 理 就 是 简单 地 将 浏览 器 端 发 送 过 来 的 消息 再 回 传 回 去 。 浏 览 器 端 则 计算 服务 器 
端 处 理 响 应 的 耗 时 。 


建立 服务 器 
首先 要 做 的 就 是 初始 化 express 并 将 weksocket .io 绑 定 到 express 上 ， 这 样 它 就 能 处 
理 WebSocket 的 请 求 了 : 


var express = require('express') 
, wsio = require('websocket.io') 


/** 
* Create express app. 
* 


var app - express.createServer(); 


/** 
* Attach websocket server. 
Li d 


var ws = wsio.attach(app) ; 


/[** 
* Serve your code 
"y 


app.use(express.static('public')); 


/** 
* Listening on connections 
“i 


ws.on('connection', function (socket) { 
Ku a ae 
): 


/** 
* Listen 
*/ 


app.listen(3000); 
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我 们 来 重点 看 下 connection 处 理 程序 。 我 特意 将 websocket. io 设计 为 与 实现 一 个 
net .Server 类 似 。 由 于 我 们 需要 直接 将 接收 到 的 消息 返回 给 客户 端 ， 所 以 ， 我 们 需要 做 的 就 
是 监听 message 事 件 ， 并 将 其 send 回 去 。 


ws.on('connection', function (socket) { 
socket.on('message', function (msg) { 
console.log(' \033[96mgot:\033[39m ' + msg); 169 
socket .send('pong') ; 
)); 
ns 


建立 客户 端 
接着 我 们 在 public 目 录 下 添加 index.html 文 件 ， 输 入 如 下 内 容 : 














index.html 


<!doctype html» 
«html» 
<head> 





<title>WebSocket echo test</title> 
<script> 


var lastMessage; 


window.onload = function () { 
// create socket 
var ws = new WebSocket ('ws://localhost:3000'); 
ws.onopen = function () { 
// send first ping 
ping(); 
} 
ws.onmessage = function (ev) { 
console.log(' got: ' + ev.data); 
// you got echo back, measure latency 
document.getElementById('latency').innerHTML - new Date - lastMessage; 
// ping again 
ping(); 
) 
function ping () ( 
// record the timestamp 
lastMessage - «new Date; 
// send the message 
ws.send('ping'); 
): 
«/script» 
</head> 
<body> 
«hl»WebSocket Echo</hi> 


<h2>Latency: <span id="latency"></span>ms</h2> 
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</body> 
</html> 





上 述 HTML 代 码 非常 直观 。 它 创建 了 一 个 占 位 符 用 于 显示 服务 器 端 处 理 的 延 时 ( 消息 来 回 
一 次 所 需要 的 时 间 ， 以 毫秒 为 单位 ) 。 


JavaScript 代 码 相 对 来 说 也 较 直 观 。 首 先 定 义 一 个 存储 延 时 的 变量 : 
var lastMessage 
接着 初始 化 WebSocket 并 和 服务 器 端 建立 连接 : 


var ws = new WebSocket('ws://localhost:3000'); 


建立 连接 后 ， 就 向 服务 器 端 发 送 第 一 条 消息 : 


ws.onopen = function () { 
ping(); 
} 


收 到 服务 器 端 响应 后 计算 耗 时 ， 并 再 次 发 出 一 条 消息 : 


ws.onmessage = function () { 
console.log(' got: ' + ev.data); 
// you got echo back, measure latency 
document .getElementById('latency').innerHTML = new Date - lastMessage; 
// ping again 
ping(); 
} 


ta, wien Mpingrh3<, ice AA THUS BU RESTE TRE UTI PA Ey (Te 
的 延 时 ) ， 随 后 发 送 一 条 简单 的 消息 给 服务 器 : 


function ping () { 
// xecord the timestamp 
lastMessage - «new Date; 
// send the message 
ws.send('ping'); 


}; 


运行 示例 程序 
输入 如 下 命令 来 运行 服务 器 端 代码 : 





$ node server.js 


fea, FT IPD YE A 7 [a http://localhost:3000 ( 见 图 10-1 ) 。 请 确保 使 用 的 浏览 器 支持 
WebSocket， 像 Chrome 15+ 或 者 IE 10+ 都 支持 。 如 果 不 确定 的 话 ， 可 以 访问 http://websocket. 
org， 查 看 网 站 右上 角 的 “Does your browser support WebSocket” 显 示 框 。 


CHAPTER 10 * WebSocket 161 


好 了 ,至 此 我 们 就 成 功 创建 了 一 个 单 用 户 的 实时 应 用 程序 。 通 过 终端 的 输出 和 浏览 器 的 控 
制 台 能 够 看 到 消息 传输 的 日 志 。 在 绝 大 多 数 现代 电脑 中 ， 消 息 传输 大 概 耗 时 1~5 上 毫秒 。 作 为 习 
题 ， 大 家 可 以 尝试 使 用 Ajax 配合 Express 的 路 由 功能 书写 一 个 同样 功能 的 应 用 程序 ， 然 后 对 比 
一 下 完成 同样 一 组 消息 的 传递 耗 时 多 久 。 





eoe WebSocket echo test " 
J| © localhost3000 - Sese] 





mE 


WebSocket Echo 


图 10-1: 一 组 消息 从 客户 端 到 服务 器 端 ， 再 返回 到 客户 端 所 需 的 时 间 
接 下 来 ,我 们 要 书写 一 个 示例 应 用 ， 该 应 用 用 于 将 多 个 用 户 连接 显示 到 一 个 屏幕 上 。 


鼠标 光标 
接 下 来 我 们 要 书写 的 程序 是 在 一 个 屏幕 上 以 鼠标 光标 样式 的 图 片 形式 展示 所 有 连接 过 来 的 
用 户 光 标的 位 置 。 


通过 本 例 ， 你 将 学 习 到 广播 的 概念 ， 也 就 是 将 一 个 消息 发 给 除了 自己 以 外 的 所 有 人 。 


初始 化 示例 程序 
书写 本 示例 程序 所 需要 的 模块 和 上 例 一 样 ， 我 们 在 package .json 定 义 这 些 依赖 : 


{ 


"name": "ws-cursors" 
, "version": "0.0.1" 
, "dependencies": ( 
"express": *2.5.1* 
, "websocket.io": "0.1.6" 


) 


建立 服务 器 «am 
建立 服务 器 的 方式 和 上 例 类 似 ， 使 用 epxress 托 管 静 态 HTMIL 文 件 ， 同 时 将 websocket .io 
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绑 定 到 express 服 务 器 上 : 


var express = require('express') 


, wsio = require('websocket.io') 


/** 
* Create express app. 
Sf 


var app = express.createServer(); 


/** 
* Attach websocket server. 
*y 


var ws = wsio.attach(app); 


jee 
* Serve your code 
y 


app.use(express.static('public')) 


/** 
* Listening on connections 
wf 


ws.on('connection', function (socket) { 
JA woo 


app.listen(3000); 


但 是 ， 本 例 中 ,在 用 户 连接 成 功 后 的 处 理 就 不 同 了 。 我 们 通过 使 用 一 个 简单 的 变量 将 所 有 
连接 过 来 的 用 户 位 置信 息 记录 在 内 存 中 。 除 此 之 外 ,我们 还 记录 下 连接 用 户 总 数 ， 来 方便 分 配 
给 每 个 用 户 一 个 唯一 的 ID 号 。 这 个 ID 号 用 来 标识 positions 对 象 中 用 户 光 标 位 置信 息 。 

var positions = {} 


, total = 0 


ws.on('connection', function (socket) { 
[fae xxu 
3); 


m> 当 用 户 连接 过 来 后 ， 我 们 首先 将 其 他 人 的 位 置信 息 作为 第 一 条 消息 内 容 发 送 给 他 。 这 样 一 
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来 ， 用 户 就 能 看 到 所 有 连接 进来 的 用 户 。 
最 后 发 送 前 ， 我 们 将 Positions 对 象 编码 为 JSON 格 式 : 


ws.on('connection', function (socket) { 
// you give the socket an id 


socket.id = ++total; 


// you send the positions of everyone else 
socket.send(JSON.stringify (positions) ); 
FI 


当 用户 发 送 消息 时 ， 我 们 就 假定 发 送 的 是 JSON 格 式 的 位 置信 息 ( 一 个 包含 x、y 坐 标的 对 
， 然 后 将 其 存储 到 Positions 对 象 中 。 


socket.on('message', function (msg) { 


E 


— 


try { 

var pos = JSON.parse (msg); 
} catch (e) { 

return; 


} 


positions[socket.id] = pos; 
)): 


最 后 ， 当 用 户 断 开 连 接 后 ， 我 们 就 把 他 的 位 置信 息 清除 : 


socket.on('close', function () { 
delete positions[socket.id]; 
10: 


是 不 是 少 了 什么 ? 没 错 ! 广播 ! 当 收 到 位 置信 息 时 ， 我 们 需要 将 其 广播 给 所 有 其 他 的 人 。 
当 socket 关 闭 时 ， 我 们 得 要 通知 所 有 其 他 人 并 将 该 光标 从 屏幕 上 移 除 。 


我 们 声明 一 个 broadcast 函 数 , 遍历 所 有 其 他 用 户 并 逐个 发 送 消 息 给 他 们 。 将 该 函数 放 
在 注册 connection 处 理 程序 的 后 面 : 


function broadcast (msg) { 
for (var i = 0, 1 = ws.clients.length; i < 1; i++) ( 
// you avoid sending a message to the same socket that broadcasts 
if (ws.clients[i] && socket.id != ws.clients[i].id) { 
// you call 'send' on the other clients 
ws.clients[i].send(msg) ; 


} 


} 
由 于 我 们 要 发 送 两 类 数据 ， 所 以 ， 我 们 在 JSON 数 据 包 中 包含 type 标 示 符 。 
发 送 位 置信 息 时 ， 数 据 结构 如 下 所 示 : 
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type: 'position' 
, pos: { x: <x>, y: <y> } 
, id: «socket id» 
} 


当 用 户 断 开 连 接 时 ， 发 送 : 


{ 
type: ‘disconnect’ 
, id: «socket id» 
) 
socket.on('message', function () ( 
4 E MERE 


broadcast(JSON.stringify(( type: 'position', pos: pos, id: socket.id ))); 
)); 


并 且 在 关闭 时 ， 发 送 : 


socket.on('close', function () { 

[T 3 

broadcast(JSON.stringify(( type: 'disconnect', id: socket.id ))); 
)): 


至 此 我 们 完成 了 服务 器 部 分 代码 ， 接 着 我 们 开始 书写 客户 端 部 分 。 


建立 客户 端 
客户 端 部 分 ， 我 们 还 是 从 一 个 简单 的 HTML 开 始 ,监听 onloaq 事 件 : 


<!doctype html> 
<html> 
<head> 
«title»WebSocket cursors</title> 
<script> 
window.onload = function () { 
var ws = new WebSocket ('ws://localhost') ; 
LE X. 
} 
</script> 
</head> 
<body> 
<hl>WebSocket cursors</h1> 
</body> 
</html> 


这 次 ， 我 们 主要 集中 在 两 个 事件 上 : openfilmessage, 


连接 建立 后 ， 开 始 监听 mousemove 事 件 ， 用 于 将 用 户 鼠 标的 位 置 实时 发 送 到 服务 器 端 ， 
再 由 服务 器 发 送 到 其 他 客户 端 。 
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ws.onopen = function () { 
document .onmousemove = function (ev) { 
ws.send(JSON.stringify({ x: ev.clientX, y: ev.clientY })); 


} 
如 在 此 前 提 到 的 ， 接 收 到 的 消息 无 外 乎 两 种 ， 要 么 是 用 户 光 标 移 动 了 ， 要 么 是 用 户 断 开 连 
接 了 : 


// we instantiate a variable to keep track of initialization for this client 


var initialized; 


ws.onmessage = function (ev) { 
var obj = JSON.parse(ev.data) ; 


// the first message is the position of all existing cursors 
if (!initialized) { 
initialized - true; 
for (var id in obj) ( 
move (id, obj[id]); 
} 
} else { 
// other messages can either be a position change or 
// a disconnection 
if ('disconnect' == obj.type) { 
remove (obj.id); 
} else { 
move(obj.id, obj.pos); 


) 


RA WAmove Filremove K% 


Xt Fmove pax, 我们 首先 要 确保 光标 对 应 的 元 素 是 否 存在 。 我 们 通过 查找 是 否 有 ID 为 
cursor-{id} 的 DOM 元 素来 完成 这 个 检查 。 如 果 元 素 不 存在 ， 那么 就 创建 一 个 图 片 元 素 , 设 
置 图 片 URL 以 及 浮动 的 样式 。 


接着 就 调整 它 在 屏幕 上 的 位 置 : 


function move (id, pos) { 
var cursor = document.getElementById('cursor-' + id); 


if (!cursor) { 


cursor = document.createElement('img'); 


cursor.id = 'cursor-' + id; 
cursor.sre = '/cursor.png'; 
cursor.style.position = ‘absolute’; 


document .body.appendChild(cursor) ; 
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} 


cursor.style.left = pos.x + 'px'; 
cursor.style.top = pos.y + 'px'; 


} 
对 于 remove 来 说 ， 只 要 简单 地 将 DOM 元 素 删除 就 好 了 : 


function remove (id) { 
var cursor = document.getElementById('cursor-' + id); 
cursor.parentNode. removeChild(cursor) ; 


} 


运行 示例 程序 
和 此 前 一 样 ， 我 们 需要 做 的 就 是 运行 服务 器 程序 ， 并 通过 浏览 器 来 访问 。 确 保 打开 了 多 个 
浏览 器 标签 页 ( 如 图 10-2 所 示 ) ， 来 体验 实时 交互 。 


eoe WebSocket cursors " 








图 10-2: 移动 的 鼠标 位 置 实 时 地 反馈 到 了 连 入 的 所 有 客户 端 cursor.png 图 片 来 自 http:// 
thenounproject.com 

m 面临 一 个 挑战 
尽管 本 例 基 本 功能 都 已 完备 ， 但 是 要 真 的 应 用 到 实际 产品 中 还 有 不 少 的 工作 要 做 。 


关闭 并 不 意味 着 断 开 连接 

当 服务 器 端 或 者 客户 端 触发 close 事 件 时 ， 意 味 着 : TCP 连 接 很 可 能 已 经 关闭 了 。 而 事实 
上 ， 并 非 总 是 如 此 。 电 脑 有 可 能 会 意外 关机 ， 网 络 错误 也 有 可 能 发 生 ， 甚 至 不 小 心 把 一 杯 水 倒 
在 了 键盘 上 都 有 可 能 。 在 类 似 这 样 的 情况 下 ，close 事 件 可 能 永远 都 不 会 触发 ! 


解决 这 个 问题 的 方法 就 是 利用 超时 和 心跳 检查 。 要 处 理 这 样 的 情况 ， 我 们 需要 每 隔 几 秒 钟 
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向 客户 端 发 送 一 段 消息 来 确保 客户 端 还 “ 活 ” 着 ， 要 是 发 送 失败 则 认为 客户 端 已 经 强制 断 开 连 
BI. 


JSON 
随 着 程序 复杂 度 的 提升 ， 服 务 器 端 和 客户 端 往返 的 数据 量 也 会 变 大 。 


在 第 二 个 示例 中 ,会 严重 依赖 JISON 进 行 手动 编码 和 解码 工作 。 因 为 这 部 分 工作 是 一 个 应 
用 中 非常 常见 的 任务 ， 所 以 需要 将 其 抽象 出 来 。 


重 连 


要 是 客户 端 临时 断 开 怎么 办 ?大 部 分 应 用 程序 会 尝试 让 用 户 自动 重 连 。 而 对 于 本 章 中 的 例 
子 来 说 ， 一 旦 发 生 断 开 情 况 ， 就 只 能 通过 刷新 浏览 器 来 重新 连接 了 。 


广播 


广播 对 于 实时 应 用 来 说 是 非常 常规 的 模式 ， 用 于 和 其 他 客户 端 进 行 交互 。 对 于 这 部 分 功 
能 ,我 们 不 需要 手动 去 定义 自己 的 广播 机 制 。 





WebSocket 属 于 HTML5: 早期 浏览 器 不 支持 
WebSocket 是 一 项 新 技术 。 大 部 分 浏览 器 、 代 理 、 防 火 墙 以 及 杀毒 软件 都 还 不 完全 支持 这 
种 新 的 协议 。 因 此 ， 我 们 需要 一 种 支持 早期 浏览 器 的 方案 。 


坚决 方案 
幸运 的 是 ， 所 有 这 些 问题 都 有 解决 方案 。 在 下 一 章 中 ， 我 们 会 介绍 使 用 一 个 名 为 
socket .io 的 模块 ， 它 的 作用 就 是 在 保持 简单 、 加 速 基 于 WebSocket 通 信 的 前 提 下 ， 解 决 所 
有 上 述 这 些 问题 。 
小 结 
本 章 介 绍 了 WebSocket API 和 WebSocket 协 议 的 基础 知识 ， 以 及 如 何在 Node.js 使 用 
WebSocket 进 行 消息 的 快速 传递 。 同 时 ， 通 过 第 一 个 示例 程序 ， 介绍 了 WebSocket 的 基本 用 法 。 


随后 ， 通 过 一 个 多 人 示例 应 用 展现 了 WebSocket 的 威力 : 它 在 消息 传递 时 只 附带 极 少 的 附 
加 数据 ， 使 得 它 能 够 以 尽 可 能 快 的 速度 完成 消息 传送 。 


最 后 ， 本 章 提 出 了 WebSocket API 并 非 所 有 浏览 器 都 支持 的 弱点 ， 并 引出 了 下 一 章 要 介绍 
的 能 够 解决 这 一 问题 的 socket.io。 


CHAPTER 


- | Socket.IO 


正如 此 前 提 过 的 ， 要 将 WebSocket 用 到 应 用 中 ， 并 非 简单 地 把 WebSocket 实 现 了 就 可 以 的 。 


Socket.IO 是 我 开发 的 一 个 项 目 ， 用 于 解决 此 前 提 过 的 使 用 WebSocket 过 程 中 一 系列 常见 问 
题 。 它 在 保留 了 简洁 API 的 前 提 下 ， 提 供 了 非常 好 的 灵活 性 。 


Server API 


io.listen(app); 
io.sockets.on('connection', function 


(socket) ( 


socket.emit('my event', ( my: 'object' }); 
ERS 
Browser/ Client API 
var socket - io.connect(); 
socket.on('my event', function (obj) { 


console.log(obj.my); 


)):; 
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传输 

Socket.IO 最 诱 人 的 特性 之 一 就 是 消息 的 传递 是 基于 传输 的 ， 而 非 全 部 依靠 WebSocket， 也 
就 是 说 ，SocketIO 可 以 在 绝 大 部 分 的 浏览 器 和 设备 上 运行 ， 从 IE6 到 iOS 都 支持 。 

例如 ， 在 使 用 一 项 称 为 Iong polling 技 术 的 时 候 ， 就 可 以 通过 Ajax 来 实现 实时 消息 传输 。 简 
单 来 说 ， 这 项 技术 是 通过 持续 发 送 一 系列 的 Ajax 请 求 来 实现 的 ， 但 是 ， 当 服务 器 端 没有 数据 返 
回 到 客户 端 时 ， 连 接 还 会 持续 打开 20 ~ 50 秒 ， 以 确保 不 再 有 额外 的 数据 通过 HTTP 请 求 / 响 应 头 
传递 过 来 。 

Socket.IO 会 自动 使 用 像 long polling 这 样 复杂 的 技术 ,但 其 API 保 持 了 与 WebSocket 一 样 的 简 
pte 

另外 ， 即 使 浏览 器 端 支持 的 WebSocket 被 代理 或 者 防火 墙 禁 止 了 ，Socket.IO 依 然 能 够 通过 
采用 别 的 技术 来 处 理 这 类 问题 。 


断 开 VS 关闭 
Socket.IO 带 来 的 男 一 个 基础 功能 就 是 对 超时 的 支持 。 正 如 我 们 在 第 6 章 和 第 10 章 中 讨论 
的 ， 在 实际 情况 下 ， 应 用 不 能 依赖 TCP 连 接 一 定 能 够 正常 关闭 。 


本 章 中 ,我 们 使 用 SocketIO ， 监 听 的 是 connect 事 件 而 不 是 open 事 件 ， 以 及 disconnect 
事件 而 不 是 close 事 件 。 原 因 是 SocketIO 提 供 了 可 靠 的 事件 机 制 。 若 客户 端 停止 传输 数据 ， 但 
在 一 定 的 时 间 内 又 没有 正常 地 关闭 连接 ，SocketIO 就 认为 它 是 断 开 连接 了 。 


这 样 一 来 ， 就 能 够 让 你 专注 在 应 用 逻辑 本 身 ， 而 无 须 去 过 多 担心 网 络 的 各 种 不 确定 情况 。 
当 连 接 丢 失 时 ，Socket.IO 默 认 会 自动 重 连 。 


Æ m 


至 此 ， 你 看 到 了 ， 典 型 的 Web 通 信和 方式 是 通过 HTTP 来 收取 (3€ ) 文档 ( 资源 ) 的 。 但 
是 ， 在 实时 Web 世 界 中 ， 都 是 基于 事件 传输 的 。 


Socket.IO 仍 然 允许 你 像 WebSocket 那 样 传输 简单 文本 信息 ， 除 此 之 外 ， 它 还 支持 通过 分 
A (emit) 和 监听 (listen) 事件 来 进行 JSON 数 据 的 收发 。 下 面 这 个 例子 展示 了 Socket.IO 像 
WebSocket 那 样 进行 消息 的 收发 : 


io.sockets.on('connection', function (socket) { 
socket.send('a'); 
Socket.on('message', function (msg) { 
console.log (msg); 
)); 
)); 
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回想 一 下 第 10 章 光标 的 例子 ， 要 是 用 SocketIO 来 实现 的 话 ， 代 码 可 以 变 得 非常 简单 : 





Client code 


var socket = io.connect(); 
socket.on('position', move); 


socket .on('remove' remove) ; 





注意 了 ， 使 用 Socket.IO 可 以 在 应 用 中 根据 数据 的 含义 进行 频道 分 类 ， 不 再 需要 对 单一 事 
fF (消息 ) 中 收 到 的 事件 进行 解析 。 事 件 可 以 接收 任意 数量 的 JSON 编 码 的 参数 : Number, 
Array, String, Object, 4%, 


命名 空间 

SocketIO 还 提供 了 另 一 个 强大 的 特性 ， 它 允许 在 单个 连接 中 利用 命名 空间 来 将 消息 彼此 区 
分 开 来 。 

有 的 时 候 ， 应 用 程序 需要 进行 逻辑 拆 分 ， 但 考虑 到 性 能 、 速 度 之 类 的 原因 ， 使 用 同一 个 连 
接 还 是 可 以 接受 的 。 考 虑 到 我 们 无 法 事先 获悉 客户 端的 速度 的 快慢 、 浏 览 器 的 好 坏 ， 不 依赖 同 
时 打开 过 多 的 连接 通常 是 个 不 错 的 主意 。 


因此 ，Socket.IO 人 允许 监听 多 个 命名 空间 中 的 connection 事 件 。 


io.sockets.on('connection'); 
io.of('/some/namespace').on('connection') 


io.of('/some/other/namespace').on('connection') 


尽管 当 通过 如 下 方式 从 浏览 器 中 获取 连接 时 ， 可 以 获取 到 不 同 的 连接 对 象 ， 但 是 ， 通 常 只 
会 使 用 一 个 传输 通道 ( 像 WebSocket 连 接 一 样 ) : 


var socket = io.connect(); 
var socket2 = io.connect('/some/namespace'); 
var socket3 = io.connect('/some/other/namespace'); 


某 些 场景 下 ， 为 了 更 好 地 抽象 ， 应 用 程序 的 部 分 代码 或 模块 书写 的 时 候 完 全 是 互相 独立 
的 。 部 分 客户 端 JavaScript 代 码 可 能 完全 不 知道 另外 一 部 分 并 行 执行 的 代码 。 


比如 ， 构 建 一 个 社交 网 络 ， 在 农场 游戏 旁边 展示 一 个 实时 聊天 程序 。 尽 管 ， 它 们 可 以 共享 
一 些 如 授权 用 户 的 信息 这 样 的 通用 的 数据 ， 但 书写 代码 时 让 它们 都 能 够 完全 控制 一 个 socket 依 
然 是 个 很 好 的 主意 。 

归功 于 命名 空间 ( 也 可 以 称 为 多 路 传输 ) ， 那 样 的 socket 不 必 非 得 是 自己 分 配 的 真正 的 


TCP socket。Socket.IO 对 同样 的 资源 ( 为 用 户 选择 的 传输 通道 ) 进行 频道 切 分 ， 并 将 数据 传输 
给 对 应 的 回调 函数 。 
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至 此 ， 你 已 经 了 解 了 SocketIO 和 WebSocket 之 间 主 要 的 不 同 点 ， 接 下 来 ， 是 时 候 开 始 构建 
第 一 个 示例 程序 一 一 聊天 程序 了 。 


聊天 程序 


初始 化 程序 
和 websocket .io 一 样 ， 将 socket .io 绑 定 到 常规 的 http .Servez 就 可 以 处 理 socket .io 
的 请 求 和 响应 了 : 





package.json 
{ 


"name": "chat.io" 
, "version": "0.0.1" 


, "dependencies": ( 


"express": "2.5.1" 
, *"socket.io"; 10.9.2" 
) 
) 


按照 惯例 ， 创 建 完 package .json 文 件 后 ， 确 保 要 运行 npm install 来 安装 所 有 的 依赖 。 


构建 服务 器 
和 websocket .io 一 样 ， 现 在 构建 一 个 带 static 中 间 件 的 普通 Express 应 用 : 








server. js 

/ k*k 
* 模块 依赖 
*4 


var express - require('express') 


, Sio = require('socket.io') 


jm 
* 创建 app 
sij 


app = express.createServer ( 
express. bodyParser () 

, express.static('public') 

) ; 


1 译 者 注 : Express3 中 需要 首先 用 http.createServer 来 将 app 绑 到 server 上 ， 需 要 添加 : var server = require("http").createServer(app); 
sio.listen(server); 。 同 时 ，Express3 中 不 能 将 中 间 件 放 在 express(…) 构 造 器 参数 中 ， 需 要 使 用 app.use(express.bodyParser()); 。 
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jee 
* 监听 
*/ 


app.listen(3000); 





接 下 来 ， 是 时 候 将 socket . io 绑 定 到 APP 上 了 。 和 websocket .io 一 样 ， 调 用 sio. 
1isten 即 可 : 


var io = sio.listen(app) ; 


接着 ， 设 置 连接 监听 器 : 


io.sockets.on('connection', function (socket) { 
console.log('Someone connected') ; 
}); 


好 了 ， 现 在 一 旦 有 连接 进来 ， 就 会 在 控制 台 输出 简单 的 信息 了 。 由 于 Socket.IO 是 自 定义 
的 API， 所 以 必须 要 在 浏览 器 中 载 人 SocketIO 客 户 端 。 


构建 客户 端 


因为 使 用 了 static 中 间 件 ， 并 将 public 目 录 设置 为 了 要 托管 的 目录 ， 接 下 来 我 们 就 在 该 目 
录 下 创建 一 个 index .html 文 件 。 


这 次 ， 为 了 方便 ， 我 们 将 聊天 程序 的 逻辑 部 分 从 HTML 代 码 中 分 离 出 来 ， 单 独 放 到 chat . 
js 文件 中 。 


Socket.IO 中 方便 的 一 点 在 于 ， 当 它 绑 定 到 http.Servez 后 ， 所 有 以 /socket .io 开始 的 
URL 都 会 被 其 拦截 。 


Socket.IO 还 自 带 了 其 浏览 器 端 运用 的 代码 。 因 此 ， 我 们 无 须 担心 如 何 获 取 和 托管 客户 端 
代码 。 


注意 ， 下 面 这 段 代 码 ， 我 们 创建 了 一 个 <script> 标 签 ， 并 添加 对 /socket .io/socket. 
io.js 的 引用 : 

















index.html 


<!doctype html> 
<html> 
<head> 
<title>Socket.IO chat</title> 
<script src="/socket.io/socket.io.js"></script> 
<script src="/chat.js"></script> 
<link href="/chat.css" rel="stylesheet" /> 
</head> 
<body> 
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PLE, chat .js 确保 客户 端 载 人 完成 后 就 开始 连接 。 若 一 切 都 正常 ， 就 应 该 能 在 控制 台 


Pan connected 这 样 的 输出 了 。 


chat.js 


所 有 SocketIO 客 户 端 代码 暴露 出 来 的 方法 和 类 都 在 io 命名 空间 中 。 


io .connect 和 new WebSocket 类 似 ， 不 过 更 


所 以 ， 它 会 尝试 向 页 面 所 在 的 主机 发 起 连接 ， 这 也 符 企 
使 用 如 下 命令 来 运行 上 述 应 用 : 


et 
智 HE 


本 例 中 ， 


本 例 的 要 求 


接着 ， 通 过 浏览 器 访问 http://localhost:3000。 


出 的 关于 Socket.IO 内 部 发 生 的 情况 ; 比如 ， 从 输出 结 
图 11-1 ) 


eoo 1. node 


node server.js 


socket.io st 

client 

handshake authorized 2495259441805103293 

setting request GET /socket.io/1/websocket/24952 
59441805103293 

set heartbeat interval for client 24952594418051 
03293 

client authorized for 

websocket writi 1 
Someone connected 





11-1: ket . io 自身 的 调试 信息 以 及 应 








像 本 例 中 那样 ， 如 果 通 过 主流 浏览 器 来 连 iras: IORS AF, 


WebSocket 来 通信 。 


因为 没有 传递 参数 给 它 ， 


应 当 就 能 看 到 Socket.IO 的 日 志 器 输 
果 中 能 够 看 到 客 


户 端 使 用 的 传输 方式 € UL 


那么 Socket.IO 就 会 使 用 
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SocketIO 总 会 尝试 选择 对 用 户 来 说 速度 最 快 、 对 服务 器 性 能 来 说 最 好 的 方法 来 建立 连接 ， 
要 是 条 件 达 不 到 ， 那 么 首先 会 保证 连接 正常 。 


事件 和 广播 
现在 已 经 成 功 连接 上 了 ， 那 么 接 下 来 就 应 该 开始 编写 SocketIO 服 务 器 端 基础 代码 了 。 
广播 用 户 加 入 信息 


当 有 用 户 连接 到 服务 器 时 ,我 们 要 通知 其 他 人 有 人 连接 进来 了 。 由 于 这 属于 非 用户 发 送 的 
特殊 消息 ， 所 以 我 们 称 之 为 通告 ， 并 用 相应 的 样式 标识 出 来 。 


客户 端 首 先 要 做 的 就 是 询问 用 户 的 名 字 。 
因为 要 在 用 户 成 功 连接 后 才能 聊天 ， 所 以 我 们 需要 先 将 聊天 窗口 隐藏 : 
chat.css 


AE ee OS 
#chat { display: none } 





接着 ， 在 用 户 连 接 成 功 后 就 将 聊天 窗口 显示 出 来 。 这 里 我 们 需要 监听 已 创建 socket 上 的 
connect 事 件 (此 前 定义 在 window.onload 中 的 函数 ) : 


chat.js 
socket.on('connect', function () ( 
// 通过 join 事件 发 送 昵 称 


socket.emit('join', prompt('What is your nickname?')); 


// 显示 聊天 窗口 
document .getElementById('chat').style.display = 'block'; 
}) 7 





服务 器 端 则 需要 监听 join 事件 ， 并 将 收 到 的 消息 通知 给 其 他 人 ， 告 诉 他 们 有 新 用 户 连接 
进来 了 。 我 们 将 此 前 的 io.sockets 的 connection 处 理 器 替换 为 如 下 形式 即 可 : 





Server.j$ 
FP we 


io.sockets.on('connection', function (socket) { 
socket.on('join', function (name) { 
socket.nickname = name; 
socket .broadcast.emit('announcement', name + ' joined the chat.'); 
)); 
)); 





175 


176 


PART Ill * Web 开 发 


注意 ，socket .broadcast .emit 中 的 broadcast 是 一 种 标志 信息 ， 它 改变 了 emit 函 
数 的 行为 。 

要 是 在 上 述 例子 中 ,我 们 直接 调用 socket .emit， 那 么 仅仅 是 将 消息 返回 给 客户 端 。 而 
我 们 真正 需要 的 是 将 消息 广播 给 所 有 其 他 的 用 户 ， 所 以 这 里 需要 broadcast 标 志 。 


再 次 回 到 客户 端 ， 我们 需要 监听 announcement 事 件 ， 并 在 DOM 的 消息 列表 中 创建 一 个 元 
素 。 将 下 述 代码 添加 到 connect 处 理 器 的 最 后 : 





chat.js 


socket.on('announcement', function (msg) { 
var li = document.createElement('li'); 
li.className = ‘announcement’ ; 
li.innerHTML = msg; 
document.getElementById('messages').appendChild(li); 
)): 


广播 聊天 消息 
接 下 来 ， 我 们 要 实现 让 用 户 发 消息 给 其 他 人 。 


当 用 户 在 表单 中 输入 消息 并 提交 时 ， 我 们 需要 分 发 一 个 text 事 件 ， 并 将 输入 的 消息 发 送 
出 去 : 


chat.js 


var input - document.getElementById('input'); 
document.getElementById('form').onsubmit - function () ( 
Socket.emit('text', input.value); 


// 重 置 输入 框 
input.value = ''; 


input .focus(); 


return false; 


} 


很 显然 ， 当 用 户 书写 完 消息 并 提交 后 ， 肯 定 不 希望 服务 器 再 将 该 消息 发 回来 。 所 以 ， 在 消 
息 发 送 后 ， 我 们 就 立刻 调用 addMessage 将 消息 显示 出 来 : 





chat.js 


function addMessage (from, text) { 
var li = document.createElement('li'); 
li.className - 'message'; 
li.innerHTML = '«b»' + from + '«/b»: ' + text; 


document.getElementById('messages').appendChild(li); 
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} 
document .getElementById('form').onsubmit:= function () ( 


addMessage('me', input.value); 
FL ox 





在 从 其 他 用 户 处 收 到 消息 后 ， 我 们 也 需要 做 同样 的 处 理 。 这 里 ， 我 们 可 以 简单 地 传递 一 个 
对 addMessage 函 数 的 引用 ， 同 时 在 服务 器 端 ， 要 确保 广播 消息 时 参数 都 正确 。 





chat.js 


PIV a 
socket.on('text', addMessage) ; 














server.|s 


socket.on('text', function (msg) { 
socket .broadcast.emit('text', socket.nickname, msg); 
}): 





至 此 ， 客 户 端 和 服务 器 端的 代码 大 致 如 下 所 示 : 188 





chat js 


window.onload = function () { 
var socket = io.connect(); 
socket.on('connect', function () { 
// 通过 join 事件 发 送 昵称 


socket.emit('join', prompt('What is your nickname?')); 


// 显示 聊天 窗口 


document .getElementById('chat').style.display = 'block'; 


socket.on('announcement', function (msg) { 
var li = document.createElement('li'); 
li.className = ‘announcement '; 
li.innerHTML = msg; 
document .getElementById('messages') .appendChild(1li); 
2); 
1): 


function addMessage (from, text) ( 
var li - document.createElement('li'); 
li.className - 'message'; 
li.innerHTML = '<b>' + from + '«/b»: ' + text; 


document.getElementById('messages').appendChild(li); 
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var input = document.getElementById('input'); 

document .getElementById('form').onsubmit = function () { 
addMessage('me', input.value); 
socket.emit('text', input.value); 


// 重 置 输入 框 
input.value = ; 
input.focus(); 


return false; 


Socket.on('text', addMessage); 


~ 








server.|s 
/ ** 


* 模块 依赖 
*J 


var express - require('express') 
, Sio = require('socket.io') 


/** 


* 创建 app 
wf 


app = express.createServer ( 
express . bodyParser () 
, express.static('public') 


/** 
* 监听 
Ef 


app.listen(3000); 
var io = sio.listen (app); 


io.sockets.on('connection', function (socket) { 
socket.on('join', function (name) { 
socket .nickname = name; 
Socket.broadcast.emit('announcement', name + ' joined the chat.'); 
1; 


Socket.on('text', function (msg) ( 
Socket.broadcast.emit('text', socket.nickname, msg); 
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eoe Socket.lO chat ml 
put: 

; 有 127.0.0.1:3000 

oS n 












e Robot joined the chat. 
e me: Hi there! 

* Robot: Oh, hai 

e Robot: How are you? 

e me: I'm fine, how are you? 
e Robot: Same! 





图 11-2: 聊天 程序 实战 。 这 里 通过 多 个 浏览 器 标签 页 来 聊天 
接 下 来 ,我 们 要 了 解 更 多 关于 事件 回调 函数 的 内 容 ， 以 及 如 何 使 用 它们 实现 新 特性 。 


息 接 收 确认 


在 聊天 应 用 中 ,我们 在 用 户 按 下 回 车 键 后 立刻 调用 addMes sage ， 这 会 让 人 产生 一 种 错 
党， 感觉 消息 瞬间 就 发 送 成 功 了 。 


和 WebSocket 一 样 ，SocketIO 并 不 强制 对 每 条 发 送 的 消息 做 回应 。 不 过 ， 有 的 时 候 ， 我 们 
需要 确认 消息 是 否 达到 。Socket.IO 把 这 类 确认 消息 叫做 确认 (acknowledgment ) 。 


要 实现 这 样 的 通知 响应 ,我 们 要 做 的 就 是 在 分 发 事件 的 时 候 提供 一 个 回调 函数 。 


首先 ， 我 们 要 获得 通过 addMessage 函 数 创建 的 消息 元 素 ， 以 便于 在 收 到 确认 响应 后 ， 对 
该 消息 添加 一 个 CSS 类 。 接 着 ， 就 可 以 在 该 消息 后 显示 一 个 漂亮 的 小 图 标 。 








/chat.js 


function addMessage (from, text) { 
PE es 
return li; 


) 








接 下 来 ， 我 们 添加 一 个 回调 函数 。Socket.IO 也 允许 在 接收 确认 响应 的 回调 函数 中 接收 数 
据 。 本 例 中 ， 可 以 在 接收 到 消息 后 发 送 一 个 时 间 戳 : 
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/chat.js 


document .getElementById('form').onsubmit = function () { 
var li = addMessage('me', input.value) ; 
socket.emit('text', input.value, function (date) { 
li.className = 'confirmed'; 
li.title - date; 
)): 


在 服务 器 端 ，Socket.IO 会 添加 一 个 回调 函数 作为 事件 的 最 后 一 个 参数 : 


/server.js/ 


How 

Socket.on('text', function (msg, fn) ( 
Ih ws 
// 确认 消息 已 接收 
fn(Date.now()); 

H; 


现在 ， 当 服务 器 端 接 收 到 客户 端 发 送 的 消息 ， 发 送 确认 响应 后 ， 一 个 CSS 类 ， 以 及 title 
属性 就 会 添加 到 消息 列表 的 最 后 一 个 元 素 中 。 这 样 做 会 带 来 两 个 好 处 : 用 户 按 下 回 车 键 后 立刻 
就 看 到 输入 的 消息 ， 这 使 得 应 用 获得 最 好 的 响应 ; 另外 还 能 通过 CSS 给 用 户 反馈 (比如 : TE 
息 后 面 显示 一 个 如 图 11-3 所 示 的 对 钓 图 标 ) 。 


eoe Socket.lO chat 
Lar) o 127.0.0.1:3000 








图 11-3: 本 例 中 ， 在 确认 响应 收 到 后 ， 利 用 CSS 设 置 一 个 背景 图 
一 个 轮流 做 DJ 的 应 用 

要 是 把 我 们 的 聊天 应 用 扩展 为 一 个 DJ 的 应 用 ， 那 得 有 多 酷 啊 ? 

" 服务 器 初始 选择 一 名 DJ。 
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* DJ 有 权利 请 求 查询 API， 获 取 查 询 结果 ， 选 择 一 首 歌 。 然 后 将 这 首 歌 广 播 给 所 有 其 他 
听众 。 
= 当 DJ 离 开 时 ， 系 统 就 会 开放 DJ 人 选 给 下 一 个 用 户 。 


扩展 聊天 应 用 
聊天 应 用 的 基础 足够 强健 ， 可 以 添加 DJ 特性 。 


首先 要 做 的 是 ,初始 化 的 时 候选 择 一 名 DJ。 因 为 我 们 还 要 记录 当前 播放 的 歌曲 ， 所 以 需 
要 申明 两 个 变量 : currentSong 和 dj。 


由 于 DJ 是 可 以 更 换 的 ， 所 以 ， 我 们 定义 一 个 elect 函 数 来 执行 选择 DJ 和 发 布 公告 的 任 
务 。 当 join 事件 分 发 时 ，DJ 就 会 被 选 出 来 ， 或 者 (已 经 有 DJ 的 情况 下 ) 将 当前 播放 的 歌曲 
(currentSong) 发 送 给 刚 加 入 的 用 户 。 后 面 ， 实 现 了 搜索 之 后 ，currentSong 会 被 包含 
在 一 个 对 象 中 发 送出 去 。 





server.js 
var io - sio.listen(app) 
, currentSong 

, dj 


function elect (socket) ( 
dj = socket; 
io.sockets.emit('announcement', socket.nickname + ' is the new dj'); 
socket.emit('elected'); 
socket.dj = true; 


socket.on('disconnect', function () { 
dj = null; 
io.sockets.emit('announcement', 'the dj left - next one to join becomes dj'); 


)); 
) 


io.sockets.on('connection', function (socket) ( 
socket.on('join', function (name) { 
Socket.nickname - name; 
socket.broadcast.emit('announcement', name + ' joined the chat.'); 
if (!dj) { 
elect (socket) ; 
} else { 


socket.emit('song', currentSong) ; 


)); 
LP ws 
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elect 函 数 完 成 如 下 几 件 事情 : 

1. 将 当前 用 户 选 为 DJ。 

2. 分 发 公告 给 所 有 人 DJ 已 经 选取 完毕 。 

3. 通过 分 发 elected 事 件 ， 让 DJ 知道 自己 被 选中 了 。 

4， 当 DJ 断 开 连 接 时 ， 将 DJ 的 名 额 留 给 下 一 个 进来 的 人 。 
客户 端 ， 将 歌曲 选择 的 界面 代码 添加 到 聊天 表单 下 面 即 可 : 


index.html 


<div id="playing"></div> 
<form id="dj"> 
<h3>Search songs</h3> 
<input type="text" id="s" /> 
<ul id="results"></ul> 
<button type=submit>Search</button> 


</form> 








Æ Grooveshark API 


Grooveshark ( http://grooveshark.com ) 提供 了 一 个 简单 易 用 的 API 一 一 TinySong， 能 满足 


我 们 的 需求 。 


TinySong 人 允许 如 下 的 查询 方式 : 
GET http://tinysong.com/s/Beethoven?key-(apiKey)&format-json 


返回 结果 如 下 : 


[ 


"Url": “http:\/\/tinysong.com\/7Wm7", 
"SongID": 8815585, 

"SongName": "Moonlight Sonata", 
"ArtistID": 1833, 

"ArtistName": "Beethoven", 

"AlbumID": 258724, 

"AlbumName": "Beethoven" 


"Url": "http:\/\/tinysong.com\/6Jk3", 
"SongID": 564004, 

"SongName": "Fur Elise", 

"ArtistID": 1833, 

"ArtistName": "Beethoven", 
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"AlbumID": 268605, 
"AlbumName": "Beethoven" 


"Url": "http:\/\/tinysong.com\/8We2", 
"SongID": 269743, 

"SongName": "The Legend Of Lil' Beethoven", 
"ArtistID": 7620, 

"ArtistName": "Sparks", 

"AlbumID": 204019, 

"AlbumName": "Sparks" 


因此 ， 我 需要 暴露 一 个 叫 search 的 Socket.IO 事 件 ， 内 部 使 用 superagent 模 块 来 进行 对 
查询 API 的 调用 并 返回 其 结果 。 


将 superagent 模 块 添加 到 package .json 中 ， 并 添加 模块 依赖 : 





server.js 


var express - require('express') 
, Sio = require('socket.io') 


, request - require('superagent') 





package.json 


, "dependencies": { 
"express": "2.5.1" 
, "socket.io": "0.9.2" 
, "superagent": "0.4.0" 


注意 了 ， 在 查询 URL 中 必须 要 包含 API key, API key 可 以 去 http://tinysong.com 网 站 申请 。 
定义 apiKey 的 方式 如 下 : 





server.|s 


var io = sio.listen(app) 
, apiKey = '{ your API key }' 
, currentSong 
, dj 





接着 ， 定 义 search 事 件 : 


socket.on('search', function (q, fn) { 
request ('http://tinysong.com/s/' + encodeURIComponent (q) 
+ '?key-' + apikey + '&format-json', function (res) ( 
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if (200 == res.status) fn(JSON.parse(res.text)); 
J:)3: 


注意 ， 上 述 代码 中 需要 手动 解析 JSON 返 回 结果 。 这 是 因为 TinySong 目 前 没有 发 送 正确 
的 Content-Type 响 应 头 信息 ， 导 致 superagent 无 法 自动 启用 JSON 解 析 功 能 。 


接着 ,我 们 要 将 查询 功能 添加 到 应 用 中 ,但 是 只 能 让 DJ 能 够 选择 歌曲 。 
在 chat .css 文 件 中 ， 添 加 如 下 两 行 代码 : 


#results a { display: none; } 
form.isDJ #results a { display: inline; } 


接着 我 们 要 添加 查询 逻辑 ， 将 从 Socket.I0 回 调 函 数 中 获取 到 的 查询 结果 展示 出 来 供 其 选 
择 。 


在 chat .js 文件 中 ,添加 如 下 内 容 : 


// search form 
var form = document.getElementById('dj'); 
var results = document.getElementById('results'); 
form.style.display = 'block'; 
form.onsubmit = function () { 
results.innerHTML = ''; 
socket.emit('search', document.getElementById('s').value, function (songs) { 
for (var i = 0, 1 = songs.length; i < Y; i++) { 
(function (song) { 
var result = document.createElement('li'); 
result.innerHTML = song.ArtistName + ' - <b>' + song.SongName + '«/b» '; 
var a = document.createElement('a'); 
a.href = '#'; 
a.innerHTML = 'Select'; 
a.onclick = function () { 
socket.emit('song', song) ; 
return false; 
} 
result.appendChild(a) ; 
results.appendChild(result) ; 
}) (songs[i]); 
} 
3); 
return false; 


socket.on('elected', function () { 
form.className = 'isDJ'; 


1); 


上 述 代 码 中 大 部 分 都 在 处 理 DOM。 因 为 服务 器 端 从 TinyURL 的 API 中 把 所 有 的 歌曲 都 发 送 
到 了 客户 端 ， 因 此 可 任 由 客户 端 对 其 进行 泻 染 。 在 本 例 中 ,我 们 首先 显示 歌手 名 ， 紧 跟着 歌曲 


CHAPTER 11 * Socket.IO 185 


名 (对 应 的 是 ArtistName 和 SongName ) 。 
在 收 到 electeq 事 件 后 ， 通 过 改变 表单 的 className 来 显示 每 首 歌曲 的 选择 链接 。 


点 击 Select 链 接 后 ， 客 户 端 发 送 song 事 件 到 服务 器 端 ， 服 务 器 端 要 做 的 就 是 记录 当前 歌 
曲 ， 并 广播 给 所 有 人 。 在 server .js 文件 中 ， 添 加 如 下 代码 : 





server.|s 


socket.on('song', function (song) { 
if (socket.dj) { 
currentSong = song; 
socket .broadcast.emit('song', song); 
} 
): 





至 此 ， 用 户 已 经 可 以 搜索 和 接收 歌曲 了 ， 最 后 就 剩 下 播放 歌曲 的 功能 了 。<div id=playing> 
元 素 就 是 为 此 而 预 留 的 。 


播放 歌曲 
和 addMessage 函 数 一 样 ,我 们 也 需要 定义 一 个 函数 来 标记 当前 正在 播放 的 歌曲 。 


将 下 述 代 码 添 加 到 chat .js 文件 中 。play 函 数 就 是 简单 地 将 当前 播放 的 歌曲 按照 歌手 、 
歌 名 的 方式 展现 出 来 ， 与 此 同时 ， 它 还 注入 了 一 个 iframe， 指 向 TinySong 的 Ur1l 字 段 ， 用 来 播 
放歌 曲 。 


var playing = document.getElementById('playing'); 
function play (song) { 

if (!song) return; 

playing.innerHTML = '<hr><b>Now Playing: </b> ' 


+ song.ArtistName + ' ' + song.SongName + '«br»'; 


var iframe = document.createElement ('iframe') ; 
iframe.frameborder = 0; 
iframe.src = song.Url; 
playing.appendChild(iframe) ; 

}; 


与 此 前 一 样 ， 该 函数 用 于 两 个 场景 : DJ ( 为 自己 ) 选择 了 一 首 歌 后 ， 以 及 DJ 向 其 他 普通 
用 户 发 送 song 事 件 的 时 候 。 


对 于 第 二 个 场景 ,我 们 只 需要 在 chat .js 中 ， 将 Play 函数 作为 回调 函数 传递 给 song 事 件 。 
Socket.on('song', play); 


对 于 DJ 要 立刻 听 到 所 选 歌曲 ， 我 们 就 需要 在 他 选择 之 后 调用 pLay 函 数 。 回 到 onclick 处 
理 器 ， 在 那里 需要 分 发 song 事 件 给 服务 器 并 调用 Play 函数 ， 因 此 ， 该 处 理 器 代码 就 会 是 如 下 
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所 示 的 样子 : 


a.onclick = function () { 
socket.emit('song', song); 


play (song); 


return false; 


} 


完成 ! 回忆 一 下 一 开始 服务 器 端 join 事件 处 理 器 部 分 代码 ， 要 是 有 currentSong 就 会 分 
发 song 事 件 。 也 就 是 说 ， 不 仅 在 DJ 选 歌曲 前 加 入 的 用 户 能 播放 歌曲 ， 在 这 之 后 填写 完 昵 称 加 
人 的 用 户 也 能 播放 歌曲 ( 见 图 11-4 ) 。 


聊天 +DJ 应 用 完整 代码 大 致 如 下 所 示 : 





server.|s 


var express = require('express') 
, Sio = require('socket.io') 


, request - require('superagent') 
app - express.createServer( 
express.bodyParser() 

, express.static('public') 


app.listen(3000); 


var io - sio.listen(app) 


, apiKey - '( your API key )' 
, currentSong 
, aj 


function elect (socket) ( 
dj = socket; 
io.sockets.emit('announcement', socket.nickname + ' is the new dj'); 
Socket.emit('elected'); 
Socket.dj - true; 


socket.on('disconnect', function () ( 

dj = null; 

io.sockets.emit('announcement', 'the dj left - next one to join becomes dj'); 
30; 


io.sockets.on('connection', function (socket) ( 
socket.on('join', function (name) { 
Socket.nickname - name; 
Socket.broadcast.emit('announcement', name + ' joined the chat.'); 
if (faj) { 
elect (socket) ; 
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) eise ( 
socket.emit('song', currentSong); 
} 
Fi 
socket.on('song', function (song) { 


if (socket.dj) { 
currentSong = song; 
socket. broadcast.emit('song', song); 


}); 


socket.on('search', function (q, fn) { 
request ('‘http://tinysong.com/s/' + encodeURIComponent (q) 
+ '?key-' + apiKey + '&format-json', function (res) ( 
if (200 -- res.status) fn(JSON.parse(res.text)); 


socket.on('text', function (msg) { 
Socket.broadcast.emit('text', socket.nickname, msg); 


)); 





chat.js 


window.onload - function () ( 
var socket - io.connect(); 
Socket.on('connect', function () { 
// 通过 join 事件 发 送 昵称 


socket.emit('join', prompt('What is your nickname?')); 


// 显示 聊天 窗口 


document.getElementById('chat').style.display = 'block'; 


Socket.on('announcement', function (msg) ( 
var li - document.createElement('li'); 
li.className = 'announcement'; 
li.innerHTML = msg; 
document .getElementById('messages') .appendChild(li); 


function addMessage (from, text) { 
var li = document.createElement('li'); 
li.className - 'message'; 
li.innerHTML = '«b»' + from + '«/b»: ' + text; 
document.getElementById('messages').appendChild(li); 
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var input = document.getElementById('input'); 

document .getElementById('form').onsubmit = function () { 
addMessage('me', input.value); 
socket.emit('text', input.value); 

// 重 置 输入 框 

input.value = ' 

input. focus (); 


return false; 


socket.on('text', addMessage) ; 


// 播放 歌曲 


var playing = document.getElementById('playing'); 


function play (song) { 


}; 


if (!song) return; 
playing.innerHTML = '«hr»«b»Now Playing: </b> ' 
+ song.ArtistName + ' ' + song.SongName + '<br>'; 


var iframe = document.createElement ('iframe') ; 
iframe.frameborder = 0; 

iframe.src = song.Url; 
playing.appendChild(iframe) ; 


socket.on('song', play); 


// 查询 表单 


var form = document.getElementById('dj'); 


var results = document.getElementById('results'); 


form.style.display = 'block'; 


form.onsubmit = function () { 


results.innerHTML = ''; 
Socket.emit('search', document.getElementById('s').value, 
for (var i= 0, 1 = songs.length; i « 1; i++) ( 
(function (song) ( 
var result - document.createElement('li'); 


function (songs) 


result.innerHTML = song.ArtistName + ' - «b»' + song.SongName + '«/b» 


var a = document.createElement('a'); 


a.href = '#'; 
a.innerHTML = 'Select'; 
a.onclick = function () { 


Socket.emit('song', song); 
play(song); 
return false; 
} 
result .appendChild(a); 
results.appendChild(result) ; 
}) (songs[i]); 


{ 


i 
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} 
1); 
return false; 
3 
socket.on('elected', function () { 
form.className = 'isDJ'; 
3); 








index.html 


<!doctype html> 
<html> 
<head> 
<title>Socket.IO chat</title> 
<script src="/socket.io/socket.io.js"></script> 
<script src="/chat.js"></script> 
<link href="/chat.css" rel="stylesheet" /> 
</head> 
<body> 
<div id="chat"> 
<ul id="messages"></ul> 
<form id="form"> 
<input type="text" id="input" /> 
<but ton>Send</button> 
</form> 
<div id="playing"></div> 


«form id="dj"> 
<h3>Search songs</h3> 
<input type="text" id="s" /> 
<ul id="results"></ul> 
<button>Search</button> 
</form> 
</div> 
</body> 
</html> 


-一 一 -一 
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201 eoe Socket.lO chat w 


alm] @ 127.0.0.1:3000 
















* Guillermo is the new dj 
Send 
Search songs 
justin Bieber 


* Justin Bieber - Mistletoe Select 





e Justin Bieber - One Less Lonely Girl Select 
e Justin Bieber - That Should Be Me Select 
* Justin Bieber - Pray Select 


小 结 

Socket.IO 提 供 了 足够 简单 但 却 十 分 强大 的 API， 用 于 构建 实时 消息 快速 通信 的 应 用 。 
SocketIO 不 仅 保 证 了 消息 会 尽 可 能 快 地 进行 传输 ， 而 且 还 能 在 所 有 的 浏览 器 以 及 绝 大 部 分 移动 
设备 上 运行 。 

本 章 介绍 了 如 何 构建 一 个 简单 的 应 用 以 及 如 何 使 用 SocketIO 提 供 的 语法 糖 。 还 介绍 了 通过 
使 用 事件 的 方式 来 组 织 用户 和 服务 器 端 传输 的 不 同类 型 的 数据 。 


书写 实时 应 用 最 基础 的 部 分 就 是 广播 。 本 章 介绍 了 如 何在 服务 器 端 分 发 事件 给 所 有 人 ， 以 
及 如 何 将 一 个 用 户 的 消息 传递 给 其 他 人 。 作 为 例子 ， 我 们 使 用 该 技术 实现 了 把 DJ 挑选 的 歌曲 
播放 给 其 他 所 有 的 用 户 。 


还 有 一 件 值得 一 提 的 事情 是 ， 绝 大 部 分 的 功能 都 在 客户 端 实现 : 编写 代码 来 根据 不 同 的 消 
息 类 型 进行 相应 的 界面 展现 。 由 于 本 章 只 关注 SocketIO， 所 以 没有 介绍 模板 引擎 以 及 其 他 更 高 
层 的 框架 ， 使 用 这 些 可 以 避免 和 DOM API 直 接 打 交道 ， 不过， 在 实际 情况 下 ， 随 着 应 用 程序 复 
杂 度 的 提高 ， 这 些 也 会 变 得 更 加 复杂 。 


数据 库 
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CHAPTER 


MongoDB 


MongoDB 是 一 个 面向 文档 ，schema 无 关 (schema-less ) 的 数据 库 ， 它 非常 适合 于 Node.js 
应 用 以 及 云端 部 署 。 

与 MySQL 及 PostgreSQL 是 根据 固定 的 结构 设计 (schema ) 将 数据 存储 在 表 中 不 同 ， 
MongoDB 可 以 将 任意 类 型 的 文档 数据 存储 到 集合 中 (schema 无 关 ) ， 这 也 是 MongoDB 最 有 意 
思 的 特性 之 一 。 





例如 ， 创 建 下 面 这 张 为 Web 应 用 保存 用 户 信息 的 表 : | 
First Last Email Twitter 
Guillermo Rauch rauchg@gmail.com rauchg 


在 构建 应 用 时 ， 决 定 将 用 户 信 息 按 照 上 面 这 样 的 结构 设计 进行 存储 。 需 要 如 下 这 些 信息 : 


first name, last name 、email 以 及 Twitter ID. 


随 着 应 用 的 发 展 、 需 求 发 生 了 改变 ， 或 者 随 着 时 间 的 推移 ， 又 有 了 新 的 需求 ， 可 能 需要 增 
加 或 者 删除 表 中 的 某 些 列 。 


然而 ， 这 样 一 个 基础 性 问题 ， 若 要 通过 传统 的 〈 SQL ) 数据 库 来 实现 ， 从 操作 上 和 性 能 上 
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来 讲 都 需要 耗费 非常 高 的 成 本 来 修改 表 设 计 。 
比如 ， 在 MySQL 中 ， 每 一 次 修改 表 的 设计 结构 ， 都 需要 运行 如 下 这 个 命令 才能 实现 添加 
一 个 新 的 列 : 


$ mysql 
> ALTER TABLE profiles ADD COLUMN . . . 


对 于 删除 一 列 或 多 列 的 情况 也 是 如 此 。 


在 MongoDB 中 ， 则 可 以 将 数据 都 看 作文 档 ， 其 设计 非常 灵活 。 当 有 数据 存储 后 ， 这 些 文 
档 就 会 以 一 种 非常 接近 (或 者 说 在 绝 大 多 数 情 况 下 就 是 JSON 格 式 ) JSON 格 式 的 形式 存储 : 


{ 


"name": "Guillermo" 

"last": "Rauch" 
, "email": "rauchg@gmail.com" 
, "age": 21 


, "twitter": "rauchg" 


) 


MongoDB 还 有 一 个 非常 重要 的 特性 ， 能 够 将 其 与 其 他 键 一 值 形式 的 NoSQL 数 据 库 区 别 开 
来 ， 就 是 文档 可 以 是 任意 深度 的 。 


例如 ， 可 以 将 社交 信息 以 如 下 结构 进行 存储 ， 而 不 是 全 都 将 它们 直接 作为 文档 的 键 来 存 


"name": "Guillermo" 
"last": "Rauch" 
"email": "rauchg@gmail.com" 
» tage": 21 
, "social networks": { 
"twitter": "rauchg" 
, "facebook": "rauchg@gmail.com" 
, "linkedin": 27760647 
) 
) 


如 上 述 代 码 所 示 ， 数 据 类 型 可 以 混用 。 这 里 ，twitter 和 facebook 信 息 都 是 字符 串 类 型 
的 ， 而 1inkedin 是 数字 类 型 。 当 通过 Node.js 获 取 到 存储 的 文档 数据 后 ， 拿 到 的 数据 类 型 也 是 
和 存储 时 一 模 一 样 的 。 


本 章 将 会 介绍 MongoDB 最 常用 的 功能 ， 以 及 如 何 获得 最 灵活 、 最 高 效 ( 通过 索引 ) 存储 
方案 的 最 佳 实 践 。 本 章 还 会 介绍 多 种 查询 文档 的 方法 ， 以 及 如 何 使 用 Mongoose 来 简化 使 用 方 
式 ，Mongoose 是 我 和 Nathan White 一 同 书写 的 Node.js 模 块 ， 它 为 MongoDB 和 JavaScript 提 供 了 
传统 关系 型 数据 库 ORM ( Object-Relational Mapper ) 的 部 分 功能 。 对 MongoDB 来 说 ， 这 类 项 目 


更 贴切 的 叫 法 应 该 是 ODM: Object Document Mapper 


记 住 ， 本 章 使 用 的 是 MongoDB 分 支 上 最 新 的 2.x 版 本 


通过 官网 ，www.mongodb.org/ 的 下 载 页 面 就 能 获取 到 MongoDB。 与 此 同时 ， 你 或 许 也 会 
有 兴趣 看 下 各 平台 下 MongoDB 的 快速 指南 : www.mongodb.org/display/DOCS/Quickstart 


通过 执行 nongo 客 户 端 ， 看 到 如 图 12-1 所 示 的 界面 就 表示 安装 成 功 了 


ann 2. mongo 


s mongo 
MongoDB shell version: 2.0.1 
connecting to: test 


> 





图 12-1: MongoDB shell 
要 是 无 法 连接 到 MongoDB ， 再 检查 下 安装 过 程 是 否 正 确 ， 同 时 通过 进程 管理 器 查看 确保 
MongoDB 服 务 器 ( mongod ) 正常 运行 


通过 Node.js 操 作 — 4 数据 最 主要 的 方式 就 是 通过 驱动 器 (driver) . 38 2$ E 
2. 动 器 指 的 就 是 一 些 基本 的 API， 它 懂得 数据 库 网 络 层 协议 和 其 通信 ， niet 
码 和 解码 存储 的 数据 


本 例 中 选择 的 是 由 Christian Amor Kvalheim 开 发 的 node-mongodb-native。 我 们 可 以 在 Node 
fuf& das (NPM ) 通过 mongodb 名 字 查 找到 这 个 驱动 需 。 


第 一 个 例子 ， 我 们 创建 一 个 简单 的 Express 应 用 ， 实 现 将 用 户 信息 存储 到 MongoDB 中 ， 并 
实现 用 户 注册 、 登 录 的 功能 。 


首先 为 项 目 创建 package .json 文 件 ， 声 明 项 目 所 依赖 的 包 。 本 例 中 ， 我们 只 需要 express 
和 mongodb。 有 除 此 之 外 ， 我 们 还 需要 使 用 jade 模 板 引擎 : 


| 译 者 注 : 截止 到 本 文 翻译 期 间 ，MongoDB 最 新 版 本 已 经 是 2.4.6 版 本 了 
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, "version": "0.0.1" 
, "dependencies": { 
"express": "2.5.8" 
, "mongodb": "0.9.9" 
, "jade*: "0.20.3* 


w 


} 


创建 Express App 
首先 ， 我 们 通过 使 用 require 引 入 所 需 的 依赖 包 : 


[ee 
* 模块 依赖 
zy 


var express require('express') 


. mongodb = require('mongodb') 


由 于 本 应 用 需要 进行 表单 处 理 ， 所 以 ， 要 用 到 bodqyParser 中 间 件 。 


因为 我 们 要 对 用 户 进行 认证 ， 并 将 该 信息 保留 下 来 ， 所 以 还 需要 用 到 session 中 间 件 ( 它 
依赖 Connect 中 的 cookieParser 中 间 件 ， 在 第 8 章 中 做 过 介绍 ) 。 


/** 


* 构建 应 用 程序 


app = express.createServer () 


/** 
* 中 间 件 
a 


app.use(express.bodyParser()); 


app.use(express.cookieParser()); 
app.use(express.session({ secret: 'my secret' })); 


因为 本 例 中 选用 了 jaaqe 模 板 引擎 ， 所 以 还 需要 设置 Express 的 view _ engine 配置 ， 
* 指定 视图 选项 
*/ 


app.set('view engine', 'jade'); 


// 若 使 用 了 Express 3， 则 不 需要 下 面 这 行 代码 


app.set('view options', { layout: false }); 
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默认 情况 下 ， 视 图 查找 路 径 是 views/。 我 们 需要 创建 该 目录 ， 并 在 该 目录 下 创建 一 个 
layoutjade 文 件 来 做 入 所 有 其 他 的 视图 : 


doctype 5 
html 
head 
title MongoDB example 
body 
hi My first MongoDB app 
hr 
block body 


尽管 这 并 不 在 本 章 范畴 ， 但是， 作为 Node.js 应 用 中 最 流行 的 模板 引擎 之 一 ， 学 习 一 些 关 
于 jade 的 内 容 还 是 很 重要 的 。 


* jade 使 用 的 是 缩 进 ( 默认 两 个 空格 ， 应 当 避 免 使 用 tab ) ， 而 不 是 复杂 的 租 套 XML 、 
HTML 标 签 。 代 码 如 下 所 示 : 


p 
span Hello world 


等 效 于 <p><span>Hello world</span></p>, 


- 使 用 jade 只 需 输入 标签 名 ， 后面 紧 跟 内 容 hl1 My First MongoDB app 即 可 ,不 需 
要 这 样 完整 地 书写 <hl>My first MongoDB app«/hl», 
这 里 使 用 doctype 5 自动 插入 了 HTML5 的 doctype。 


” 代码 中 还 使 用 了 特殊 的 关键 字 block， 这 样 其 他 视图 文件 就 能 能 入 到 这 个 位 置 。 这 就 
是 为 什么 要 称 该 文件 为 layout 的 原因 。 其 他 还 包括 ifE 和 else 这 样 特殊 的 关键 字 。 

= 属性 的 写法 看 起 来 就 像 是 HTML 和 JavaScript 代 码 的 混合 体 ， 并 且 非 常 容 易 艇 入 变 量 
(或 者 locals ，express 将 从 controller 中 暴露 给 视图 层 的 变量 称 为 locals ) : 


a(href=#, another=attribute, dynamic=someVariable) My link 
" BY LAS HORROR HK A TIER: 
p Welcome back, #{user.name} 


接着 定义 路 由 。 我 们 需要 一 个 主页 的 路 由 (/ ) 、 注 册页 面 的 路 由 ( /signup) 以 及 登录 
页 面 的 路 由 ( /login) : 

yee 

* 默认 路 由 

*/ 


app.get('/', function (req, res) { 
res.render('index', { authenticated: false }); 
VG 
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,/** 
* 登录 路 由 


wf 


app.get('/login', function (req, res) { 
res.render('login'); 


)): 


/** 
*/ 


app.get('/signup', function (req, res) ( 
res.render('signup'); 


)); 


在 主页 的 路 由 中 ( / ) ， 我 们 传递 了 一 个 值 为 false 的 本 地 变量 authenticated。 等 实 
现 了 登录 功能 后 ， 我 们 会 动态 输出 该 变量 。 


我 们 在 index 模 板 中 需要 用 到 authenticated 变 量 : 





index.jade 


extends layout 
block body 
if (authenticated) 
p Welcome back, #{me.first} 
a(href-"/logout") Logout 
[211^ else 
p Welcome new visitor! 
ul 
li: a(href-"/login") Login 
li: a(href-"/signup") Signup 


如 图 12-2 所 示 ， 注 册 和 登录 视图 就 是 简单 的 表单 视图 : 





signup.jade 
extends layout 
block body 
form(action-"/signup", method-"POST") 
fieldset 
legend Sign up 
p 
label First 
input(name-"user[first]", type-"text") 
p 
label Last 
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input (name="user[last]", type="text") 


label Email 
input (name="user[email]", type="text") 


label Password 
input (name="user[password]", type="password") 


button Submit 


a(href="/") Go back 





login.jade 
extends layout 
block body 
form(action="/login", method="POST") 
fieldset 
legend Log in 
p 
label Email 
input(name-"user[email]", type-"text") 


label Password 
input(name-"user[password]", type-"password") 


button Submit 


P 
a(href-"/") Go back 


eoe 


My first MongoDB app 





图 12-2: /signup 路 由 
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[22 5 最 后 ， 我 们 需要 让 应 用 程序 监听 3000 端 口 : 
jee 
* 监听 
*/ 


app.listen(3000); 


要 是 通过 浏览 器 访问 ， 就 能 够 很 容易 地 访问 到 所 有 定义 好 的 路 由 。 


连接 MongoDB 
在 查找 文档 ( 登录 功能 所 需 ) 和 插入 文档 (注册 功能 所 需 ) 之 前 ， 先 要 连接 MongoDB 服 
务 器 并 选择 正确 的 数据 库 。 


我 们 需要 在 服务 器 监听 前 就 连接 数据 库 。 因 为 应 用 逻辑 完全 依赖 数据 库 的 操作 ， 在 还 未 能 
查询 数据 前 就 接收 请 求 显然 是 不 行 的 。 


由 于 我 们 直接 使 用 了 MongoDB 的 驱动 器 ， 所 以 API 有 些 长 。 不 过 ,我们 的 目的 是 要 暴露 像 
app.users 这 样 MongoDB 和 集合 的 API， 方 便 在 路 由 定义 中 轻松 对 数据 库 进行 操作 。 
首先 通过 创建 一 个 nongodb .Server 并 提供 IP 和 端口 来 初始 化 服务 器 : 


ja 
sd « 连接 数据 库 


/ 


var server = new mongodb.Server('127.0.0.1', 27017) 


接着 告诉 驱动 器 去 连接 数据 库 。 比 如 ， 取 一 个 叫 my-website 的 数据 库 名 字 。 在 MongoDB 
中 ， 要 是 指定 的 名 字 不 存在 ， 就 会 创建 一 个 数据 库 。 


new mongodb.Db('my-website', server).open(function (err, client) { 
要 是 连接 数据 库 失败 ， 我 们 就 得 终止 进程 : 
// 在 有 错误 的 情况 下 不 允许 应 用 程序 启动 


if (err) throw err; 

要 是 连接 成 功 则 打印 成 功 的 消息 : 

console.log ('\033[96m + \033[39m connected to mongodb'); 
接着 ， 建 立 集合 : 

// 建立 集合 快捷 方式 


app.users = new mongodb.Collection(client, 'users'); 


最 后 ， 让 Express 服 务 器 监听 端口 准备 操作 集合 : 


如 果 运 行 应 用 程序 


要 是 这 个 时 候 通过 mongo 客 户 端 ， 


示 的 连接 成 功 的 消息 ! 


ADA 


2956 mapped: 249 

Fri May 11 22:57: 
2956 mapped:249 
Fri May 11 23:02 
2956 mapped:249 
Fri May 11 23:07 
2956 mapped: 2490 


749 [cli 


Fri May 11 23:11:17 [initandlisten] connection 


m 127.0.0.1:51836 #562 


>I 
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插入 文档 的 API 很 简单 
以 及 一 个 回调 果 数 就 可 以 了 
本 例 中 ， 第 二 个 参数 是 


另外 还 有 一 


要 


下 面 会 看 到 ， 


(确保 数据 库 运 行 正常 ) ， 


49 [clientcursormon] mem (MB) 


entcursormon] mem (MB) 


:49 [clientcursormon] mem (MB) 





个 options 对 象 ， 


是 回头 再 来 看 注册 表单 y 


当 bodyParser 遇 到 这 


fax, MongoM¢ras 


运行 show log 


2. mongo 


res:18 virt: 
res:18 virt: 
res:18 virt: 


accepted fro 


的 本 地 


本 地 Web 月 Rs 


简单 地 调用 Col1 
和 绝 大 多 数 Node 中 的 回调 男 数 - 


.个 插入 的 文档 数组 


iment ' 


的 第 二 个 参数 ， 后 面 


是 可 选 


会 发 现 输 入 框 的 名 


会 


文 样 的 格式 ， 


globalfm^, 


ection#insert 方 法 ， 


这 遵循 这 样 的 格式 : user [field] 


hs 


大 致 会 输出 如 下 形式 的 消息 : 


应 当 会 看 到 如 图 12-3 所 





法 ， 并 提供 要 插入 的 文档 
第 一 个 参数 是 一 个 错误 对 


会 做 相应 介绍 


, 例如; 


产生 req.body.user.name 这 样 的 字段 
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这 个 功能 可 以 很 方便 地 让 我 们 直接 将 文档 插入 到 MongoDB 中 。 对 于 本 例 ， 我 们 忽略 数据 
校 验 〈 非 常 重要 ) 。 


这 样 一 来 ， 处 理 注册 的 路 由 就 变 得 非常 简单 : 


jw 
* 处 理 注册 的 路 由 
*4 


app.post('/signup', function (req, res, next) { 
app.users.insert (req.body.user, function (err, doc) { 
if (err) return next(err); 
res.redirect('/login/' + doc[0].email); 
Fi 
}); 


[215 > 若 遇 到 错误 ， 需 要 调用 next ， 这 样 就 可 以 显示 一 个 “错误 500” 页 面 。 尽 管 错 误 不 会 频繁 
发 生 ， 但 重要 的 是 必须 要 对 其 进行 处 理 。 


在 处 理 了 错误 之 后 ， 最 常 犯 的 错误 就 是 忘记 return。 这 种 错误 会 在 应 用 程序 中 产生 无 法 
预知 的 行为 。 比 如 ， 这 个 时 候 有 错误 发 生 了 ，doc 变 量 就 会 是 undefined， 这 样 一 来 代码 就 会 
抛 出 无 法 捕获 的 异常 。 


插入 文档 成 功 后 ， 将 应 用 程序 重 定向 到 登录 路 由 ， 并 提供 email 字 段 。 
在 登录 路 由 中 ， 我 们 获取 email 参 数 ， 并 将 其 暴露 给 视图 : 


/** 
* 登录 路 由 
ey 


app.get('/login/:signupEmail', function (req, res) { 
res.render('login', { signupEmail: req.params.signupEmail }); 
1): 


在 视图 中 ， 我 们 显示 一 个 消息 : 


if (signupEmail) 


p Congratulations on signing up! Please login below. 


然后 ， 将 email 变 量 输 出 到 email 输 入 框 中 : 


input (name="user[email]", type="text", value-signupEmail) 


现在 启动 应 用 程序 验证 一 下 注册 功能 ! 这 时 ， 若 启动 nongo 客 户 端 ， 在 新 创建 的 集合 上 运 
行 find 命 令 ， 应 该 就 能 看 到 刚刚 创建 的 文档 内 容 了 : 
Brian: in the mongo client things appear like this$ mongo my-website 
> db.users.find() 
{ "first" : "A", "last" : "B", "email" : "aGb.com", "password" : "d", “_id" : Object 
Id ("4ef2cbd77bb50163a7000001") ) 
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注意 ， 上 述 文档 看 起 来 和 你 插入 的 完全 一 样 ， 相 当 直观 。 除 此 之 外 ， Mongo 自 动 添加 了 
_id 字 段 ， 用 来 唯一 确定 文档 内 容 。 非 常 方 便 ! 


查找 文档 

至 此 我 们 已 经 创建 好 了 文档 ， 接 下 来 就 可 以 在 /1ogin 路 由 中 对 文档 进行 查询 了 。 我 们 要 
获取 的 是 匹配 对 应 email 和 password 的 文档 。 

在 MongoDB 中 ， 没 有 固定 的 schema 能 确定 一 个 集合 ， 因 此 ， 每 次 对 集合 进行 特定 方式 查 
询 时 ， 确 保 正 确 地 对 其 进行 了 索引 会 是 个 不 错 的 主意 。 特 别 是 当 某 个 键 是 在 舱 套 结构 中 时 ， 要 
是 没有 对 其 进行 索引 ， 会 导致 一 次 扫描 整 表 的 查询 操作 ， 会 导致 应 用 程序 性 能 的 下 降 。 

MongoDB 有 一 个 ensureIndex 命 令 ， 顾 名 思 义 ,不 管 索引 是 否 存在 ， 都 可 以 调用 这 个 命 
令 来 确保 在 查询 前 建立 了 索引 。 我 们 可 以 在 应 用 初始 化 的 时 候 调 用 它 。 


在 设置 了 app.users 后 ， 我 们 应 当 调用 两 次 ensureIndex: 


client.ensureIndex('users', 'email', function (err) { 





if (err) throw err; 
client.ensureIndex('users', 'password', function (err) ( 


if (err) throw err; 


console.log('\033[96m + \033[39m ensured indexes'); 


// 监听 
app.listen(3000, function () { 
console.log('\033[96m + \033[39m app listening on *:3000'); 
b) 5 
)):; 
)); 


重启 应 用 后 ， 会 发 现 有 额外 日 志 : 


node server.js 


$ 
+ connected to mongodb 
+ ensured indexes 

x 


app listening on :3000 
现在 就 可 以 查询 了 ! 
/** 


* 登录 处 理 路 由 
x 


app.post('/login', function (req, res) { 
app.users.findOne(( email: req.body.user.email, password: req.body.user.password 
), function (err, doc) ( 
if (err) return next(err); 


if (!doc) return res.send('«p»User not found. Go back and try again</p>'); 
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req.session.loggedIn = doc. id.toString(); 
res.redirect('/'); 
Pie 
1); 


和 insert 命 令 一 样 ，findone 命 令 可 以 对 MongoDB 进 行 查询 文档 的 操作 。 


我 们 将 _ig 存 储 为 session 的 一 部 分 ， 这 样 可 以 在 用 户 访问 其 他 路 由 时 ， 能 够 获取 当前 登录 
用 户 的 信息 。 注 意 这 里 ， 我 们 显 式 地 将 MongoDB ObjectId 存 储 为 字符 串 类 型 ， 其 表现 形式 是 
十 六 进 制 的 。 


最 后 ， 还 要 实现 /Logout 路 由 ， 处 理 非 常 简单 ， 清 除 session 就 好 了 。 记 住 ，req.session 
对 象 可 以 随意 修改 ， 在 做 出 响应 后 〈 比如 本 例 中 的 重 定向 ) ，Express 会 自动 将 其 保存 下 来 。 


p** 
* 登 出 路 由 
wy 


app.get('/logout', function (req, res) { 
req.session.loggedIn - null; 
res.redirect('/'); 

): 


在 这 个 例子 中 ， 我 们 保留 了 session ， 并 将 其 ID 设置 成 了 nu1l1。 或 者 ， 若 想 完 全 清楚 
session， 可 以 直接 调用 req.session.regenerate () 。 


身份 验证 中 间 件 
我 们 开发 的 绝 大 多 数 应 用 貌似 在 不 止 一 处 都 需要 访问 验证 后 登录 用 户 的 信息 。 


若 回 过 头 来 再 看 一 下 index .jade， 我 们 需要 访问 me 对 象 来 获取 匹配 登录 用 户 的 文档 信 
与 此 同时 ， 还 要 通过 authenticated 变 量 来 判断 用 户 是 否 已 经 通过 了 身份 验证 。 


if (authenticated) 


. p Welcome back, #{me.name} 


a(href-"/logout") Logout 
我 们 可 以 定义 一 个 中 间 件 ， 将 这 两 个 变量 (authenticated, me) 暴露 给 视图 使 用 。 这 
里 需要 用 到 Express 的 res.local API: 
/** 
* 身份 验证 中 间 件 
*/ 


app.use(function (req, res, next) { 
if (req.session.loggedIn) { 
res.local('authenticated', true); 
app.users.findOne(( id: ( $oid: req.session.loggedIn ) ), function (err, doc) ( 
if (err) return next(err); 


res.local('me', doc); 
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next (); 
)); 
) else ( 
res.local('authenticated', false); 
next(); 
) 
)); 


注意 了 ， 在 调用 findone 时 ,我 们 传递 了 $oia 修 饰 符 。 它 允许 直接 传递 一 个 字符 串 而 不 用 
传递 一 个 0bjectId 对 象 。 回 忆 一 下 ， 之 前 我 们 调用 了 toString 来 确保 存储 的 loggedIn 是 
字符 串 。 

记得 移 除 此 前 在 index 路 由 中 用 来 测试 的 {fauthenticated:false}， 现 在 这 部 分 代码 应 
该 是 这 样 的 ( 见 图 12-4 ) : 


app.get('/', function (req, res) { 
res.render('index'); 


}) 7? 








eoo MongoDB example x 
Ls Ta" G] 127.0.0.1:3000 








My first MongoDB app 





Welcome back, Guillermo 


图 12-4: 用 户 成 功 登 录 后 的 界面 
此 前 的 应 用 没有 考虑 实际 场景 下 必要 的 一 些 基础 特性 。 接 下 来 的 三 部 分 内 容 会 对 其 进行 介绍 。 


校 验 
若 用户 提 交 的 表单 太 大 ， 该 怎么 办 呢 ? 按照 此 前 例子 的 处 理 方式 ， 就 会 直接 向 数据 库 中 插 
入 这 么 大 的 文档 数据 了 。 


除 此 之 外 ,我 们 也 许 还 应 该 在 存储 数据 前 确保 emai1 字 段 确 实 是 email1 字 段 ， 密 码 应 该 是 
不 少 于 6 个 字符 的 字符 串 ， 而 不 是 Date 或 者 是 Number。 


我 们 也 不 想 在 每 次 对 数据 库 进 行 插入 、 更 新 、 查 询 操作 的 时 候 都 要 重复 上 述 校 验 规 则 。 


Mongoose 通 过 允许 在 应 用 层 定义 schema 来 解决 这 个 问题 ， 它 在 保持 文档 灵活 性 和 易 改 动 <219] 
的 前 提 下 ， 引 入 了 特定 的 属性 对 其 做 一 定 的 约束 ， 称 为 模型 。 
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原子 性 

假设 我 们 基于 Express 和 MongoDB 书 写 一 个 博客 引擎 。 可 想 而 知 ， 其 中 一 部 分 功能 会 是 允 
许 用 户 修改 博文 的 标题 和 内 容 ， 可 能 还 有 一 部 分 功能 是 允许 编辑 和 删除 标签 。 
面向 文档 设计 的 MongoDB 非 常 适合 这 样 的 场景 。 在 posts 集 合 中 ,文档 可 能 会 是 这 样 的 : 


{ 


"title": "I just bought Smashing Node.JS" 

, "author": "John Ward" 

, "content": "I went to the bookstore and picked up. . ." 
"tags": ["node.js", "learning", "book"] 


2 

假设 ， 这 个 时 候 ， 有 两 个 人 ， 用 户 A 想 要 编辑 文档 的 标题 ， 与 此 同时 ， 用 户 B 想 要 添加 一 
个 标签 。 

如 果 两 个 用 户 都 传递 了 一 份 完整 的 文档 拷贝 来 进行 更 新 操作 ， 那 么 只 有 一 个 会 胜出 。 另 外 
一 个 将 无 法 成 功 完成 对 文档 的 修改 。 

要 确保 某 个 操作 的 原子 性 ，MongoDB 提 供 了 $set 和 $push 这 样 不 同 的 操作 符 : 


db.blogposts.update({ id: «id» }, { $set: { title: 'My title' } }) 
db.blogposts.update(( . id: «id» }, { tags: { $push: "new tag" }) 


Mongoose 则 是 通过 检查 要 对 文档 做 的 修改 ， 并 只 修改 受 影 响 的 字段 来 解决 这 个 问题 。 就 
算 操作 的 是 数组 ( 包括 文档 数组 ) ， 原 子 性 依然 能 够 得 到 保证 。 
安全 模式 
此 前 介绍 过 ， 在 使 用 驱动 器 时 ， 我 们 可 以 在 操作 文档 时 提供 一 个 可 选 的 options 人 参数 : 
app.users.insert({ }, { <options> }) 
其 中 一 个 选项 叫 safe， 它 会 在 对 数据 库 进行 修改 时 启动 安全 模式 。 


默认 情况 下 ， 在 操作 完成 后 ， 如 果 有 错误 发 生 ，MongoDB 不 会 及 时 通知 你 。 驱 动 器 需要 
在 操作 完成 后 进行 一 个 特殊 的 函数 调用 db .getLastError， 来 验证 数据 修改 是 否 成 功 。 


这 背后 的 原因 在 于 对 于 许多 应 用 来 说 ， 相 比 于 要 知道 某 个 操作 是 否 失败 而 言 ， 速 度 更 为 重 
要 。 比 如 ， 丢 了 某 些 日 志 并 不 是 什么 世界 末日 ,但 是 导致 性 能 低下 就 无 法 接受 了 。 


Mongoose 默 认 会 对 所 有 操作 启用 安全 模式 ， 当 然 了 ， 你 可 以 关闭 这 个 选项 。 


Mongoose 介 绍 
按照 惯例 ， 在 开始 使 用 Mongoose 前 ， 先 要 在 package.json 文 件 中 定义 对 Mongoose 的 依赖 ， 
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然后 通过 require 将 其 引入 : 
var mongoose = require('mongoose') 


相 比 原生 的 驱动 器 ，Mongoose 做 的 第 一 个 简化 的 事情 就 是 它 假定 绝 大 部 分 的 应 用 程序 都 
是 用 一 个 数据 库 ， 这 大 大 简化 了 使 用 方式 。 要 连接 数据 库 ， 只 需要 调用 mongoose.connect 
并 提供 mongodb://URI 即 可 : 


mongoose.connect('mongodb://localhost/my database'); 


另外 ， 使 用 Mongoose， 就 无 须 关 心 连接 是 否 真 的 已 经 建立 了 ， 因 为 ， 它 会 先 把 数据 库 操 
作 指 令 缓 存 起 来 ， 在 连接 上 数据 库 后 就 会 把 这 些 操作 发 送 给 MongoDB。 这 就 意味 着 ,我 们 无 
须 监听 connection 的 回调 函数 。 连 接 后 就 可 以 直接 像 下 面 要 介绍 的 这 样 开始 查询 数据 了 。 


定义 模型 
模型 是 Schema 类 的 简单 实例 。 在 指定 字段 时 ， 简 单 地 使 用 对 应 类 型 的 JavaScript 原 生 的 构 
造 器 即 可 : 


var Schema = mongoose.Schema 
, ObjectId = Schema.ObjectId; 





var PostSchema = new Schema({ 
author : Objectid 
, title : String 
, body : String 
, date : Date 
)); 


这 些 类 型 是 : 

= Date 

a String 

" Number 

= Array 

" Object 

除 此 之 外 ，MongoDB 还 提供 了 一 种 ObjectIq 类 型 ， 这 种 类 型 可 以 通过 Schema .ObjectId 
来 获得 。 

在 这 个 博客 例子 中 ,我 们 可 以 将 创建 博文 的 用 户 存储 为 ObjectId 类 型 。 

Mongoose 还 为 给 定 的 字段 提供 了 一 些 不 同 的 选项 。 在 提供 选项 时 ， 需 要 在 一 个 对 象 中 
引用 对 应 字段 类 型 的 构造 器 。 比 如 ， 要 给 字段 提供 了 一 个 默认 值 ， 可 以 按照 如 下 方式 提供 
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default 和 type 选 项 : 
var PostSchema = new Schema ({ 
author : ObjectId 
, title : { type: String, default: 'Untitled' ) 
, body : String 
, date : Date 


3): 


创建 好 Schema 后 ， 通 过 mongoose 来 注册 一 个 模型 : 


var Post = mongoose.model('BlogPost', PostSchema) ; 


对 于 本 例 ，Mongoose 将 集合 名 字 设 置 为 blogposts ， 除 非 我 们 通过 第 三 个 参数 来 指定 集 
合 名 。Mongoose 默 认 会 对 模型 名 字 使 用 小 写 复 数 形 式 。 


随后 要 想 获取 模型 ， 可 以 通过 调用 mongoose .mode1 方 法 并 提供 模型 名 : 


var Post = mongoose.model('BlogPost'); 
接着 就 可 以 操作 模型 了 。 要 创建 一 个 博客 文章 ， 只 要 使 用 new 操 作 符 就 可 以 了 : 


new Post({ title: 'My title' }).save(function (err) { 
console.log('that was easy!'); 
)); 


有 一 点 很 重要 : Schema 只 是 一 种 简单 的 抽象 ， 用 以 描述 模型 的 样子 以 及 它 是 如 何 工 作 
数据 的 交互 发 生 在 模型 上 ， 而 不 是 Schema 上 。 

因此 ， 若 要 查询 ， 与 使 用 new 关 键 字 来 初始 化 博文 相对 ， 需 要 执行 静态 的 Post . find 方 法 
(或 者 其 他 一 些 会 在 下 面 介绍 的 方法 ) 。 


的 


o 


考虑 到 数据 的 组 织 ， 有 的 时 候 以 子 结构 的 形式 来 组 织 键 也 非常 有 帮助 : 


var BlogPost = new Schema ({ 


author : Objectid 
, title : String 
, body : String 
， meta : f 


votes : Number 

, favs : Number 
} 
39; 


在 MongoDB 中 ， 可 以 使 用 点 来 操作 这 些 属性 。 比 如 ， 要 查找 拥有 指定 投票 数 的 博文 ， 可 
以 通过 如 下 方式 来 实现 : 


db.blogposts.find(( 'meta.votes': 5 }) 
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EMRE 
在 MongoDB 中 ,文档 可 以 很 大 ， 也 可 以 层次 很 深 。 也 就 是 说 ， 如 果 博 文 有 留言 的 话 ， 可 
以 直接 将 留言 定义 在 博文 中 ， 而 不 需要 将 其 定义 为 单独 的 集合 。 


var Comments = new Schema ({ 


title : String 
, body : String 
, date : Date 


var BlogPost = new Schema({ 


author : Objectid 
, title : String 
, body : String 
, buf : Buffer 
, date : Date 
, comments : [Comments] 
, meta 2 { 


votes : Number 

, favs : Number 
} 
)): 


Mongoose 还 允许 为 该 字段 定义 想 要 的 类 型 。 


构建 索引 
正如 此 前 提 到 过 的 ， 索 引 是 在 MongoDB 数 据 库 中 确保 快速 查询 的 重要 因素 。 
要 对 指定 的 键 做 索引 ， 需 要 传递 一 个 index 选 项 ， 并 将 值 设 置 为 true。 « 2:3] 


比如 ， 要 对 title 键 做 索引 ， 并 将 uid 键 设置 为 唯一 ， 可 以 这 样 : 


var BlogPost = new Schema({ 


author : ObjectIQ 
, title : { type: String, index: true } 
, uid : ( type: Number, unique: true ) 


): 


要 设置 更 复杂 的 索引 (如 组 合 索引 ) ， 可 以 使 用 静态 的 index 方 法 : 


BlogPost.index(( key: -1, otherKey: 1 }); 

rh [B] fF 
在 相当 一 部 分 应 用 中 ， 有 的 时 候 会 在 不 同 的 地 方 以 不 同 的 方式 对 同样 的 数据 进行 修改 。 
通过 模型 接口 将 这 部 分 对 数据 库 的 交互 集中 处 理 是 避免 代码 重复 很 有 效 的 方式 。 
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Mongoose 通 过 引入 中 间 件 来 实现 。Mongoose 中 间 件 的 工作 方式 和 Express 中 间 件 非常 相 
似 。 你 可 以 定义 一 些 方法 ， 在 某 些 特定 动作 前 执行 : save 和 remove。 


比如 ， 要 在 博文 删除 时 ， 发 送 电子 邮件 给 作者 ， 可 以 通过 下 面 的 方式 来 实现 : 


Blogpost.pre('remove', function (next) { 
emailAuthor(this.email, ‘Blog post removed!); 
next () ; 

] ) ; 


还 可 以 对 单个 动作 定义 多 次 中 间 件 来 执行 各 类 操作 ， 特 别 是 异步 操作 。 


探测 模型 状态 
很 多 时 候 ， 我 们 需要 根据 要 对 当前 模型 做 的 不 同 更 改进 行 不 同 的 操作 : 


Blogpost.pre('save', function (next) { 
if (this.isNew) { 
// doSomething 
} else { 
// doSomethingElse 


: 


})3 


还 可 以 通过 this.dirtyPaths 来 探测 什么 键 被 修改 了 。 


查询 
在 Model 实 例 上 暴露 的 所 有 常见 的 操作 有 : 
= find 
" findOne 
a remove 
a update 
a count 


Mongoose 还 添加 了 findById， 该 方法 接受 一 个 ObjectId 去 匹配 文档 的 id 属性 。 


扩展 查询 
如 果 对 某 个 查询 不 提供 回调 函数 ， 那 么 直到 调用 run 它 才 会 执行 : 


Post.find(( author: '4ef2cbffb1d9807fa7000001' }) 


-where('title', 'My title') 
.Sort('content', -1) 
.limit(5) 


.run(function(err, post) ( 
Bde ow: oe, 
}) 
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HE 
要 进行 排序 ， 只 需 提 供 排序 的 键 以 及 排序 的 顺序 即 可 : 


query.sort('key', 1) 
query.sort('some.key', -1) 


选择 
若 文档 很 大 ， 而 想 要 的 只 是 部 分 指定 的 键 ， 那 么 就 可 以 调用 Query#select 方 法 。 
比如 ， 要 显示 带 链接 的 博文 列表 ， 无 须 获取 所 有 的 字段 ( 有 些 字段 可 能 数据 量 很 大 ) : 


Post.find() 
.select('field', 'field2') 














限制 
要 限制 查询 结果 的 数量 ， 可 以 调用 Query#1imit 方 法 : 


query.limit(5) 
跳 过 
要 跳 过 指定 数量 的 文档 数据 ， 可 以 通过 如 下 方式 : 


query.skip(10); 


这 个 功能 结合 Model#count 对 做 分 页 非常 有 用 : 


Post.count(function (err, totalPosts) { 
var numPages = Math.ceil(totalPosts / 10); 


)); 
自动 产生 键 
在 BlogPost 模 型 例子 中 ， 我 们 将 博文 作者 的 ID 存储 为 author 属 性 。 


很 多 时 候 ， 在 查询 一 个 博文 时 ， 我 们 还 需要 获取 对 应 的 作者 。 这 个 时 候 ， 就 可 以 为 
ObjectId 类 型 提供 一 个 ref 属 性 : 


var BlogPost = new Schema({ 





author : ( type: ObjectId, ref: 'Author' } 
e tithe : String 
, body : String 
, meta = { 


votes : Number 
, favs : Number 
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之 后 ， 查 询 文档 时 就 能 自动 产生 作者 数据 ! 通过 简单 地 对 指定 键 调用 populate 方 法 即 可 : 


BlogPost.find({ title: 'My title' }) 
.populate('author') 
.run(function (err, doc) ( 
console.log(doc.author.email); 


}) 


转换 
因为 Mongoose 提 前 知道 需要 什么 样 的 数据 类 型 ， 所 以 它 总 是 会 尝试 去 做 类 型 转换 。 


例如 ， 有 一 个 年 龄 字段 ， 在 Schema 中 描述 的 是 Number 类 型 。 如 果 有 人 在 网 站 中 提交 了 
一 个 普通 表单 ， 那么 在 没有 JSON 或 者 特定 逻辑 处 理 的 情况 下 ， 我 们 得 到 的 是 字符 串 而 不 是 数 
字 。 Mongoose 利 用 了 动态 语言 的 特性 ， 所 以 对 它 来 说 在 存储 前 将 '21' (字符 串 ) 转化 为 21 
(数字 ) 就 没有 什么 问题 了 。 


同样 的 情况 还 会 发 生 在 ObjectId。 在 此 前 的 例子 中 ， 我 们 不 得 不 使 用 $oiqd 修 饰 符 来 让 
使 用 字符 串 形式 ObjectID 的 查询 操作 成 功 执行 然而， 这样 的 方式 过 于 元 长 。 我 们 可 以 直接 传 
递 "4ef2cbd77bb50163a7000001" 给 Mongoose， 它 会 自动 将 其 转化 为 ObjectId ("4ef2c 
bd77bb50163a7000001") 。 


除 此 之 外 ， 当 类 型 不 匹配 并 且 转 换 失 败 时 ，Mongoose 会 抛 出 一 个 校 验 错误 ， 并 且 放 弃 对 
文档 的 存储 。 这 种 行为 在 一 致 性 和 文档 的 整洁 性 上 确保 了 易 用 性 。 


一 个 使 用 Mongoose 的 例子 

和 此 前 我 们 做 的 一 样 : 先 使 用 node http 模 块 ， 然 后 再 使 用 Connect 和 Express 来 对 其 改进 。 
接 下 来 ,我 们 要 用 Mongoose 对 此 前 的 例子 进行 重 构 ， 以 此 来 展现 Mongoose 在 表现 形式 上 对 数 
据 表 提供 的 好 处 。 


我 们 从 创建 一 个 新 的 package .json 并 添加 对 mongoose 的 依赖 开始 。 


构建 应 用 
新 的 pPackage .json 文 件 如 下 所 示 : 


{ 
"name": "mongoose-example" 
, "version": "0.0.1" 
, "dependencies": ( 
"express": "2.5.2" 
, "mongoose": "2.5.10" 
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和 往常 一 样 ， 运 行 npm instal1 来 安装 所 需 的 依赖 。 接 下 来 ， 我 们 重 构 一 下 服务 器 端 主 
要 的 代码 。 


重 构 
我 们 从 此 前 例子 中 将 server .js 文件 和 views 目 录 复 制 过 来 。 


首先 要 重 构 的 就 是 将 对 mongodb 的 依赖 替换 为 nongoose， 因 为 mongodb 并 未 出 现在 
package.json 文 件 中 。 事 实 上 ，mongoose 内 部 就 是 使 用 了 mongodb。 


server .js 顶部 代码 如 下 所 示 : <227] 


/** 
* 模块 依赖 
&/ 


var express - require('express') 


, Mongoose = require('mongoose') 


现在 ， 我 们 要 将 注意 力 放 在 该 文件 底部 代码 上 ， 也 就 是 连接 数据 库 的 代码 : 


/** 
* 连接 数据 库 
Fy 


var server = new mongodb.Server('127.0.0.1', 27017) 
jJ x37 


正如 此 前 提 到 的 ，mongoose 大 大 简化 了 连接 数据 库 、 操 作 集 合 、 建 立 索 引 等 的 操作 。 
server .js 文件 最 后 一 部 分 代码 就 可 以 简化 为 如 下 形式 : 


/** 
* 连接 数据 库 
wy 


mongoose.connect('mongodb://127.0.0.1/my-website'); 
app.listen(3000, function () ( 

console.log('\033[96m + \033[39m app listening on *:3000'); 
)); 


接 下 来 ， 我们 要 定义 模型 来 取代 app .users 这 种 引用 方式 ， 并 建立 此 前 建立 的 索引 。 
建立 模型 

模型 可 以 在 文件 任意 位 置 通过 Mongoose 定 义 。 无 所 谓 Mongoose 是 否 已 经 与 数据 库 连 接 。 

在 文件 最 后 ， 我 们 加 上 对 模型 的 定义 : 


/** 
* 定义 模型 
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*/ 
var Schema - mongoose.Schema 


var User - mongoose.model('User', new Schema(í 
first: String 
, last: String 
, email: ( type: String, unique: true ) 
, password: { type: String, index: true } 


3)):; 


接 下 来 我 们 再 看 用 它 来 替换 app.users 的 地 方 。 第 一 处 就 是 身份 认证 中 间 件 。 我 们 用 


Mongoose 提 供 的 便利 的 findqById 方 法 来 替换 使 用 $oid 的 地 方 : 


app.use(function (req, res, next) { 
if (req.session.loggedIn) { 

res.local('authenticated', true); 

User.findById(req.session.loggedIn, function (err, doc) ( 
if (err) return next(err); 
res.local('me', doc); 
next(); 

)); 


) else ( 
res.local('authenticated', false); 


next (); 
) 
30; 


在 登录 的 POST 路 由 中 ， 需 要 再 次 用 到 模型 方法 。 这 次 是 findone: 


app.post('/login', function (req, res) ( 
User.findOne({ email: req.body.user.email, password: req.body.user.password }, 


function (err, doc) ( 
if (err) return next(err); 
if (!doc) return res.send('«p»User not found. Go back and try again'); 


reg.session.loggedIn - doc. id.toString(); 
res.redirect('/'); 
)); 
3): 


正如 此 前 提 到 过 的 ， 模 型 可 以 静态 方式 使 用 ( 正如 那 两 个 例子 所 示 的 ) ， 也 可 以 当 构造 器 
使 用 。 
注册 的 POST 路 由 应 该 重 构成 如 下 形式 : 


app.post('/signup', function (req, res, next) { 
var user = new User(req.body.user).save(function (err) { 
if (err) return next (err); 
res.redirect('/login/' + user.email); 
3); 
)); 
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注意 ， 我 们 不 再 需要 一 个 包含 了 文档 信息 的 回调 函数 。 我 们 只 需 在 回调 函数 中 使 用 创建 的 
模型 实例 即 可 (使 用 user .email 而 不 是 doc[0] .email ) 。 


重 构 完成 ! 再 次 运行 Server .js, 一 切 都 应 该 运行 正常 不过， 代码 变 得 更 为 整洁 ， 更 
容易 理解 了 o 
小 结 

本 章 介 绍 了 Node.js 世 界 中 最 流行 的 数据 库 之 一 : MongoDB, 

本 章 介绍 了 关于 文档 数据 库 是 如 何 工 作 的 基本 知识 ， 还 介绍 了 Node.js 中 MongoDB 的 驱 
动 器 。 

你 会 注意 到 ， 它 处 理 数 据 的 方式 非常 自然 ， 另 外 ， 对 数据 在 浏览 器 和 Web 服 务 器 之 间 传 递 
的 映射 也 非常 好 。 


通过 重 构 第 一 个 例子 ， 现 在 ， 你 应 当 能 够 体会 到 本 章 介 绍 的 引入 了 模型 概念 以 及 非常 方便 
的 API 框 架 一 一 Mongoose 的 好 处 了 。 





CHAPTER 


MySQL 


尽管 现 如 今 NoSQL 渐 行 其 道 ， 越 来 越 流行 ， 但 是 SQL 数据 库 依 旧 是 绝 大 多 数 应 用 的 选择 。 < 

Node.js 丰 富 的 生态 系统 中 ， 有 许多 模块 都 是 为 SQL 数据 库 设计 开发 的 ， 特 别 是 本 章 要 介绍 
的 : MySQL. i 

与 第 12 章 中 介绍 MongoDB 一 样 ， 本 章 会 先 介绍 一 个 原生 的 MySQL 驱 动 器 ( 一 个 名 为 node- 
mysql 的 项 目 ) 。 

通过 node-mysql， 我 们 可 以 书写 自己 的 SQL 查询 语句 来 操作 数据 库 。 

除了 驱动 器 之 外 ,本章 还 会 介绍 如 何 使 用 MySQL 的 对 象 关 系 映射 器 (ORM ) 
sequelize。 正 如 上 一 章 介绍 的 ，ORM 提 供 了 一 个 MySQL 数 据 库 中 数据 到 JavaScript 模 型 对 象 的 
映射 ， 使 得 操作 数据 关系 、 数 据 处 理 等 变 得 更 加 容易 。 





node- 


node-mysal <22] 
要 学 习 如 何 使 用 node-mysql， 我 们 从 创建 一 个 简单 的 购物 车 应 用 的 模型 开始 。 


初始 化 项 目 
按照 惯例 ， 我 们 从 添加 对 express、jade 还 有 node-mysql 的 依赖 开始 : 
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package. json 


{ 
"name": "shopping-cart-example" 
i “version”: "0.0.1" 
, "dependencies": { 
"express": "2.5.2" 
, "jade": "0.19.0" 
, "mysql": "0.9.5* 


Express FB 
接 下 来 ， 我 们 创建 一 个 简单 的 Express 应 用 ， 并 添加 如 下 路 由 : 
= /: 展示 所 有 的 商品 以 及 创建 商品 的 表单 。 
* /item/<id>: 展示 指定 的 商品 以 及 用 户 评价 。 
* /item//review (POST): 创建 一 个 评价 。 
= /item/create (POST): 创建 一 个 商品 。 


对 于 首页 以 及 商品 的 路 由 ， 我 们 将 泻 染 简 单 的 模板 。 注 意 了 ， 我 们 配置 了 Express 的 view 
options， 将 模板 布局 取消 了 ， 这 符合 Express 3 的 行为 。 模 板 布局 将 直接 通过 jade 来 实现 。 





server.|s 


/** 
* 模块 依赖 
"d 


var express - require('express') 


/** 
* 创建 应 用 
*/ 
[283 > app - express.createServer(); 
{** 
* 配置 应 用 
2 À 
app.set('view engine', 'jade'); 
app.set('views', _ dirname + '/views'); 


app.set('view options', { layout: false }); 
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/** 
* 首页 路 由 
"y 


app.get('/', function (req, res, next) ( 
res.render('index'); 


3); 


[er ‘ 
* 创建 商品 路 由 
*7 


app.post('/create', function (req, res, next) ( 
}); 


/** 
* 查看 商品 路 由 
* iy 


app.get('/item/:id', function (req, res, next) { 
res.render('item'); 
)): 


/** 
* 创建 商品 评价 路 由 


app.post('/item/:id/review', function (req, res, next) { 
}); 


/** 
* 监听 
*J 
app.listen(3000, function () ( 
console.log(' - listening on http://*:3000'); 


bh 


连接 MySQL 
下 一 步 是 添加 对 node-mysql 的 依赖 : 





server. js 


var express = require('express') 
, mysql = require('mysql') 





要 初始 化 连接 ， 和 创建 net 客 户 端 所 使 用 的 Node AP 方式 一 样 ， 我 们 通过 调用 createClient 
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方法 来 实现 。 

和 Mongoose 对 mongodb 的 处 理 方式 一 样 ， node-mysql 在 真正 连接 到 MySQL 前 就 可 以 接收 指 
令 ， 并 将 它们 缓存 起 来 (也 就 是 将 它们 存储 在 内 存 中 ) ， 当 连接 建立 后 ， 就 一 次 性 将 它们 全 部 
发 送 给 MySQL。 

所 以 ,我们 无 须 监听 connection 事 件 或 者 提供 回调 函数 ， 只 需 简 单 地 初始 化 客户 端 ， 提 供 
相应 的 设置 即 可 。 将 下 列 代码 添加 到 应 用 配置 部 分 的 下 方 : 





server.|s 

/ 次 再 
* 连接 MySQL 
wi} 


var db = mysql.createClient ({ 
host: 'localhost' 
, database: 'cart-example' 
)); 





若 要 设置 数据 库 的 用 户 名 和 密码 ， 就 在 调用 createCclient 方 法 时 在 参数 中 传递 User 和 
password 选 项 。 要 了 解 更 多 关于 node-mysql 的 用 法 ， 可 以 查看 其 官方 文档 http://github.com/ 
felixge/node-mysql。 
初始 化 脚本 

在 应 用 程序 中 使 用 SQL 数据 库 前 ， 我 们 总 是 先 要 创建 必要 的 数据 库 和 表 。 

为 了 让 代码 重用 ， 我 们 创建 一 个 名 为 setup .js 的 简单 node 脚 本 来 运行 必要 的 CREATE 
TRBLE 命 令 。 


由 于 连接 数据 库 所 需 参 数 和 此 前 书写 在 应 用 中 的 是 一 样 的 ， 所 以 我 们 先 将 这 些 参数 的 配置 
抽象 到 一 个 config .json 文 件 中 : 


config.json 
( 
"host": "localhost" 
, "database": "cart-example" 


) 





注意 了 ， 有 效 的 JavaScript 代 码 未 必 一 定 是 有 效 的 JSON。 本 例 中 ,我 们 将 所 有 的 键 都 用 引 
号 括 起 来 ， 并 且 要 确保 所 有 的 值 都 使 用 的 是 双 引 号 而 不 是 单 引号 。 


从 Node 0.6 开 始 ， 就 可 以 直接 使 用 require 来 引入 JSON 文 件 ， 而 无 须 再 用 JSON.parse 和 
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fs#readFileSync 了 。 接 下 来 ,编辑 修改 依赖 的 模块 : 





server.|s 

/ ** 

* 模块 依赖 
wy 


var express = require('express') 
, mysql = require('mysql') 


, config = require('./config') 


fh = 3 8 





在 连接 数据 库 的 代码 部 分 ， 使 用 config 来 替换 原先 的 参数 对 象 : 





server.js 


var db = mysql.createClient (config); 
接 下 来 准备 创建 启动 脚本 。 该 脚本 只 依赖 mysql 和 config， 因 为 它 是 从 命令 行 直接 运行 的 。 


setup.js 

/ ** 
* 模块 依赖 
*/ 


var mysql = require('mysql') 


, config = require('./config') 





下 面 初始 化 客户 端 ， 由 于 数据 库 还 未 创建 好 ， 所 以 需要 将 config 中 的 database 字 段 删除 : 


setup.is 
/** 
* 初始 化 客户 端 
£f 
delete config.database; 
var db - mysql.createClient(config); 


node-mysql 提 供 的 执行 查询 语句 的 API 非 常 简单 : client.query(<sql>, 
<callback>) 。 关 闭 连接 的 API 是 client .end。 


由 于 我 们 使 用 单个 TCP 连 接 ， 所 以 服务 器 接收 到 的 指令 顺序 和 我 们 书写 的 顺序 是 一 致 的 。 
也 就 意味 着 ， 不 需要 为 了 确保 执行 顺序 而 嵌 套 回调 函数 : 
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// 没有 必要 这 么 做 ! 


db.query('CREATE TABLE. . .', function (err) { 
db.query('CREATE TABLE. . .', function (err) { 
db.query('CREATE TABLE. . .', function (err) ( )); 


E 
)); 


为 了 确保 能 够 将 错误 报告 给 用 户 ， 还 需要 监听 db error diff: 


db.on('error', function () { 
// handle error 
p); 


对 于 中 断 程序 而 言 ， 当 错误 发 生 时 ， 最 好 的 处 理 方式 是 将 错误 和 调用 堆 都 展示 给 用 户 并 终 
止 程序 。 你 或 许 还 记得 第 4 章 中 介绍 的 ， 当 错误 对 象 通 过 EventEmitter 分 发 出 来 , 但 又 没有 
对 应 的 监听 器 时 ( 也 就 是 说 事件 未 处 理 ) ，Node 会 将 错误 抛 出 ， 确 保 开 发 者 能 够 意识 到 错误 
的 发 生 ， 而 不 是 将 错误 “ 知 ” 掉 。 因 此 ， 事 实 上 ， 对 于 本 例 ， 我 们 无 须 专门 添加 一 个 错误 处 理 
器 ， 因 为 Node 会 将 未 处 理 的 错误 直接 抛 出 。 


首先 ， 我 们 需要 创建 数据 库 并 告诉 MySQL 要 使 用 该 数据 库 : 


setup.js 

/** 

* 创建 数据 库 
Ey 


db.query('CREATE DATABASE IF NOT EXISTS `cart-example`'); 
db.query('USE `cart-example`'); 





setup.js 

/ ** 

* 创建 表 
ty 


db.query('DROP TABLE IF EXISTS item'); 

db.query('CREATE TABLE item (' + 

'id INT(11) AUTO_INCREMENT,' + 

'title VARCHAR (255),' + 

'description TEXT,' + 

‘created DATETIME,' + 

'PRIMARY KEY (id))'); 
db.query('DROP TABLE IF EXISTS review'); 
db.query('CREATE TABLE review (' + 

‘id INT(11) AUTO_INCREMENT,' + 

'item id INT(11),' + 

"text TEXT,' + 


setup.|s 


正如 我 们 在 第 3 章 中 介绍 的 ， ae 轮 询 中 没有 任务 要 处 理 时 ，Node 就 会 退出 该 进程 。 在 
连接 MySQL 服 务 器 的 过 程 中 ， 我 们 打开 了 一 个 文件 描述 符 ， 于 是 Node 事 件 轮 询 机 制 就 会 开始 
监听 。 当 调用 结束 客户 端 时 ， HU LAN 关闭 ， 因 此 ， 也 要 结束 程序 


代码 如 下 所 示 : 


setup.js 


接 下 来 测试 刚刚 书写 的 脚本 : 


， 我 们 可 以 用 mysql 客 户 端 确认 下 ， 数 据 库 和 表 都 已 经 创建 好 了 ( 见 图 13-1 ) 


ysqi» L DAT S; 
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$ mysql 
> show databases; 


> use cart-examples; 


> SHOW TABLES; 


创建 数据 
接 下 来 ， 我 们 在 views 目 录 下 创建 一 个 简单 的 布局 。 如 下 所 示 ， 该 文件 包含 一 个 特殊 的 jade 
block boqy 声 明 ， 用 于 将 其 他 视图 人 族人: ; 





views /layout.jade 


doctype 5 
html 
head 
title My shopping cart 
body 
hl My shopping cart 


*cart 


block body 


index 文 件 展 示 了 一 个 包含 所 有 商品 的 列表 ， 以 及 用 于 创建 新 商品 的 表单 : 





views /index.jade 


extends layout 
block body 

h2 All items 

if (items.length) 


ul 
each item in items 
li 
h3: a(href="/item/#{item.id}")= item.title 
= item.description 
else 


p No items to show 


h2 Create new item 


form(action-"/create", method="POST") 
p 
label Title 
input(type-"text", name-"title") 
p 
label Description 


CHAPTER 13 * MySQL 225 


textarea (name="description") 


p 
button Submit 





因为 在 上 述 代码 中 ， 通 过 检查 length 属 性 来 展示 items 数 组 项 ， 所 以 ,我 们 暂且 先 确 保 
在 /路 由 中 传递 一 个 空 数组 ， 如 下 所 示 。 当 然 了 ,真正 的 数据 稍 后 肯定 是 从 数据 库 中 获得 的 。 





server.|s 


app.get('/', function (req, res, next) { 
res.render('index', { items: [] )); 
Pie 








对 于 商品 查看 页 面 ， 我 们 需要 商品 本 身 、 关 于 它 的 评价 以 及 创建 新 评价 的 表单 。 





views /item.jade 


extends layout 


block body 
a(href="/") Go back 


h2= item.title 


p= item.description 


h3 User reviews 


if (reviews.length) 
each review in reviews 
- review 
b #{review.stars} stars 
p= review.text 
hr 
else 


p No reviews to show. Write one! 


form(action="/item/#{item.id}/review", method-"POST") 
fieldset 
legend Create review 
p 
label Stars 
select (name="stars") 
option 1 
option 2 
option 3 
option 4 
option 5 
p 
label Review 
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textarea (name="text") 


p 
button(type-"submit") Send 





注意 在 上 述 代码 中 ， 表单 的 action 属 性 部 分 使 用 了 jade 的 插 补 特性 。 通过 使 用 # COH 以 一 
种 安全 的 方式 ( HTML 的 实体 会 被 转 义 ) 来 引入 变量 。 如 果 想 要 引入 不 需要 转 义 的 字符 串 变 
量 ,可 以 使 用 ! {}。 


在 开始 获取 数据 前 ， 我 们 需要 先 创建 数据 来 做 简单 的 测试 。 
在 项 目 配 置 代 码 下 方 ， 添 加 bodyParser 中 间 件 来 处 理 POST 请 求 : 





server.|s 


/** 
* 中 间 件 
xy 


app.use(express.bodyParser()); 





接着 ， 完 成 /create 路 由 : 


— 





server.|s 


- 创建 商品 路 由 
*/ 


app.post ('/create', function (req, res, next) { 
db.query('INSERT INTO item SET title = ?, description = ?', 
[req.body.title, req.body.description], function (err, info) ( 
if (err) return next(err); 
console.log(' - item created with id $s', info.insertId); 
res.redirect('/'); 
5 
)); 





上 述 代码 有 两 部 分 非常 意思 。 第 一 部 分 是 db . query 允 许 用 后 面 提供 的 数据 蔡 换 ? 记 号 。 
通过 这 种 替换 记号 的 方式 ， 可 以 有 效 地 避免 字符 串 的 拼接 ， 从 而 避免 SQL 注入 攻击 。 如 果 在 查 
询 语句 中 包含 了 ?记号 ， 那 么 需要 提供 一 个 包含 要 替换 数据 的 数组 作为 第 二 个 参数 。 


男 外 一 部 分 有 意思 的 是 info 对 象 。 本 例 中 ,我 们 通过 insertId 来 获取 创建 商品 的 ID。 
只 要 不 发 生 错 误 ， 这 个 属性 一 直 都 在 。 如 果 有 错误 发 生 ， 我 们 就 终止 处 理 ， 并 调用 next 方 


创建 评价 的 路 由 也 类 似 : 


通过 运行 上 述 应 用 并 创建 一 个 商品 来 做 测试 ( 见 图 13-2 ) 
eoe My shopping cart 
127.0.0.1:3000 
My shopping cart 
All items 
No items to show 


Create new item 
Title New item 


Description 
Description 


Submit 





lay 


13-2. #BnwBAO, BStlewaAgck 


之 后 ， 就 能 在 控 人 


a 


i ex Sa E3-3 9 TR JP ETT 





eoo 1. node 
x_node server.js 

listening on http://*:3000 
- item created with id 1 
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获取 数据 


通过 node-mysql 从 MySQL 中 获取 数据 是 非常 简单 直观 的 。 当 执行 的 命令 是 SELECT 时 ， 回 


调 函 数 中 会 接收 一 个 包含 查询 结果 对 象 的 数组 。 数 组 中 的 对 象 包含 了 指定 返回 的 字段 。 根 据 本 
章 所 属 范畴 ， 我 们 将 只 讨论 SELECT 指令 。 


回调 函数 中 接收 到 的 是 数组 ， 这 其 实 和 我 们 在 index.jade 模 板 中 想 要 的 数据 结构 是 一 致 


的 ， 模 板 中 ， 我 们 需要 遍历 数组 ， 并 显示 其 id、title 以 及 description 属 性 。 


因此 ， 我 们 要 做 的 就 是 检查 是 否 有 错误 发 生 ， 如 果 没 有 ， 就 把 查询 结果 传递 给 视图 : 


j** 
* 首页 路 由 
* 
app.get('/', function (req, res, next) ( 

db.query('SELECT id, title, description FROM item', function (err, results) ( 
res.render('index', ( items: results )); 

)); 
}); 


/路 由 完成 后 ， 就 可 以 重启 应 用 ， 查 看 所 有 商品 的 列表 了 。 


对 于 列表 中 包含 的 查看 商品 路 由 ， 我 们 需要 获取 商品 数据 ， 确 保 它 存在 ， 并 获取 相关 的 评 
如 果 商 品 不 存在 ， 就 返回 404 状 态 码 。 


为 了 让 代码 更 可 读 ， 我 们 将 逻辑 按照 执行 顺序 拆 分 到 几 个 函数 中 : 


server.|s 

/** 

* 查看 商品 路 由 
"y 


app.get('/item/:id', function (req, res, next) { 
function getItem (fn) { 
db.query('SELECT id, title, description FROM item WHERE id = ? LIMIT 1’, 
[req.params.id], function (err, results) { 
if (err) return next(err); 
if (!results[0]) return res.send(404); 
fn(results[0]); 
J)a 
} 


function getReviews (item_id, fn) { 
db.query('SELECT text, stars FROM review WHERE item_id = ?', 
[item_id], function (err, results) { 
if (err) return next (err); 
fn (results); 


}); 
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) 


getItem(function (item) ( 
getReviews(item.id, function (reviews) ( 
res.render('item', ( item: item, reviews: reviews }); 
he 
)); 
3: 


图 13-4 展 示 了 完成 后 的 应 用 。 现 在 可 以 浏览 商品 、 提 交 评 价 以 及 在 界面 上 看 到 它们 的 信息 
ds 












eoo My shopping cart 
4)» | ®© 127.0.0.1:3000 . "— € jifeas 


My shopping cart 
All items 


e Smashing Node 
A book about Node JS. 

e Smashing jQuery 
jQuery explained. 


e Smashing All 


图 13-4: 完整 应 用 展示 


sequelize 
在 此 前 的 例子 中 ， 直 接 操 作 SQL 数 据 库 的 方式 多 少 有 些 问题 。 


第 一 个 问题 就 是 建 表 的 过 程 是 手动 的 〈 耗 时 ) ， 而 且 表 的 定义 并 非 项 目 本 身 的 一 部 分 。 应 
用 程序 根本 无 法 得 知 商 品 的 title 属 性 只 能 允许 最 多 255 个 字符 。 如 果 能 够 知道 ， 那 么 应 用 程序 就 
可 以 对 用 户 的 输入 做 校 验 ， 并 显示 错误 信息 。 


解决 这 个 问题 的 方式 就 是 使 用 sequelize: 通过 它 可 以 定义 schema 和 模型 ， 同 时 还 可 以 使 用 
其 同步 的 特性 ， 根 据 那些 定义 来 创建 要 使 用 的 数据 库 表 。 这 样 一 来 ， 此 前 例子 中 的 setup .js 
就 不 再 需要 了 。 
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因为 schema 也 是 应 用 程序 的 一 部 分 ， 我 们 可 以 使 用 它们 来 做 类 型 转化 。 要 存储 包含 指定 数 
据 的 商品 ， 我 们 可 以 直接 传递 一 个 JavaScript 的 Date 对 象 ， 而 无 须 手 动 构造 MySQL 需 要 的 日 期 
格式 。 

最 后 一 点 ， 同 时 也 是 很 重要 的 一 点 就 是 联合 。 在 此 前 的 例子 中 ， 我 们 是 手动 去 获取 商品 的 
评价 信息 的 ， 而 通过 sequelize， 可 以 自动 获取 这 部 分 数据 。 

我 们 通过 创建 一 个 简单 的 任务 列表 应 用 ,来 运用 sequelize 为 数据 库 表 带 来 的 不 同 的 概念 和 
特性 。 任 务 可 以 根据 项 目 来 分 组 。 我 们 可 以 添加 、 创 建 和 删除 项 目 ， 同 时 也 可 以 在 指定 项 目 
中 ， 添 加 、 创 建 和 删除 任务 。 


初始 化 Seque1ize 
由 于 sequelize 内 部 使 用 了 node-mysql 驱 动 器 ， 所 以 依赖 列表 就 可 以 是 如 下 形式 : 





package. json 
I 
"name": "todo-list-example" 
, "version": "0.0.1" 
, "dependencies": { 
"express": "2.5.2" 
, "jade": "0.19.0* 
, "sequelize": "1.3.7" 


) 





初始 化 Express 应 用 

这 部 分 应 用 将 与 以 往 传 统 的 应 用 有 所 不 同 ， 这 次 在 创建 和 删除 商品 时 将 采用 Ajax 的 方式 。 
我 们 可 以 通过 使 用 DELETE 方 法 让 应 用 程序 更 加 RESTful。 若 你 对 REST 还 不 熟悉 ,那么 简单 
来 说 它 就 是 一 系列 准则 ， 引 入 了 一 种 HTTP 协 议 更 宽泛 的 使 用 方式 ， 使 得 像 HTTP 的 PATCH、 
DELETE 以 及 平时 不 常 使 用 的 状态 码 为 我 们 所 用 。 


定义 的 路 由 如 下 所 示 : 

= / (GET): 获取 所 有 项 目 。 

= /projects (POST): 创建 项 目 。 

" /project/:id (DELETE): 删除 项 目 。 

* /project/:id/tasks (GET): 获取 任务 。 
" /project/:id/tasks (POST): 添加 任务 。 
* /task/:id (DELETE): 删除 任务 。 


/** 

* 模块 依赖 

*/ 

var express - require('express') 


/** 
* 创建 应 用 
£j 


app = express.createServer(); 


/** 

x 配置 应 用 

sy 
app.set('view engine', 'jade'); 
app.set('views', X dirname + '/views'); 


app.set('view options', { layout: false }); 


/** 


* 首页 路 由 
*/ 


app.get('/', function (req, res, next) ( 
res.render('index'); 
}); 


[** 
* 删除 项 目 路 由 
*y 


app.del('/project/:id', function (req, res, next) ( 
3); 


/** 


* 创建 项 目 路 由 


*y 


app.post('/projects', function (req, res, next) { 
1); 


/** 
* 展示 指定 项 目 中 的 任务 
Fy 


app.get('/project/:id/tasks, function (req, res, next) 
1); 


/[** 
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* 为 指定 项 目 添加 任务 
*/ 


app.post('/project/:id/tasks, function (req, res, next) { 
}); 


** 


x 删除 任务 路 由 
247 */ 


app.del('/task/:id', function (req, res, next) { 


/** 
* 监听 
*/ 
app.listen(3000, function () { 
console.log(' - listening on http://*:3000'); 


) 


我 们 再 定义 一 个 简单 的 布局 ， 这 次 使 用 jQuery 来 更 容易 地 发 送 Ajax 请 求 : 





views /layout.jade 


doctype 5 
html 
head 
title TODO list app 
script (src="http://code.jquery.com/jquery-1.7.2.js") 
script (src="/js/main.js") 
body 
h1 TODO list app 
#todo 
block body 


注意 了 ， 在 上 述 代 码 中 ,， 载 人 了 main.js 文 件 ， 该 文件 将 包含 所 有 的 客户 端 逻 辑 ( 如 : 
发 送 Ajax 请 求 来 提交 表单 ) 。 


项 目 和 任务 列表 展示 方式 一 样 ， 因 为 它们 都 有 添加 和 删除 操作 : 





views /index.jade 


extends layout 


block body 
h2 Projects 


#list 
ul#projects-list 
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each project in projects 
li 
a(href="/project/#{project.id}/items")= project.title 
a.delete(href="/project/#{project.id}") x 


form#add(action="/projects", method-"POST") 
input (type="text", name="title") 








button(type="submit”) Addviews/tasks.jade 


h2 Tasks for project #{project.title} 


#list 
ul#tasks-list 
each task in tasks 
li 
span- task.title 
a.delete(href="/task/#{task.id} ") x 


form#add (action="/project/#{project.id}/tasks", method-"POST") 
input (type="text", name="title") 
button Add 
连接 sequelize 
现在 ， 我 们 需要 将 sequelize 添 加 到 模块 依赖 中 : 





server.|s 

7 ** 
* 模块 依赖 
y 


var express = require('express') 
, Sequelize = require('sequelize') 





接 下 来 初始 化 主 类 。 我 们 可 以 直接 在 模块 依赖 后 做 这 个 初始 化 工作 ， 也 可 以 出 于 对 程序 结 
构 清 晰 的 考虑 ， 在 应 用 设置 后 做 。 





server.|s 


/** 
* 初始 化 sequelize 
*J 


var sequelize = new Sequelize('todo-example', 'root') 
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Sequelize 构 造 器 接收 如 下 参数 : 
"= database (String) 
a username (String) - 必要 
* password (String) - 可 选 
* other options (Object) - 可 选 
* host (String) 
* port (Number) 
可 以 使 用 如 下 命令 行 来 创建 数据 库 。 记 住 将 root 和 替换 为 在 Sequelize 构 造 器 中 使 用 的 
MySQL 用 户 名 : 


$ mysqldmin -u root -p create todo-exmaple 
定义 模型 和 同步 

要 定义 模型 ， 需 要 调用 sequelize.define 方 法 。 我 们 可 以 在 引入 sequelize 后 直接 调用 该 
方法 。 该 方法 第 一 个 参数 是 模型 名 ， 第 二 个 参数 是 包含 了 属性 的 对 象 。 





server.|s 


var Project = sequelize.define('Project', { 
title: Sequelize.STRING 
, Gescription: Sequelize.TEXT 
, created: Sequelize.DATE 
}); 





在 上 述 代码 中 ， 属 性 的 类 型 对 应 如 下 sequelize 中 的 类 型 。 接 下 来 ， 每 种 类 型 都 对 应 MySQL 
中 的 类 型 : 

* Sequelize.STRING // VARCHAR(255) 

" Sequelize.BOOLEAN // TINYINT(1) 

a Sequelize.TEXT // TEXT 

* Sequelize.DATE // DATETIME 

= Sequelize. INTEGER // INT 

除了 传递 类 型 之 外 ， 还 可 以 传递 一 个 包含 选项 的 对 象 ， 比 如 ， 要 设置 默认 值 ， 就 可 以 传递 : 

title: { type: Sequelize.STRING, defaultValue: 'No title' } 


接 下 来 定义 任务 模型 : 
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server.js 

/** 
* 定义 任务 模型 
ia | 


var Task = sequelize.define('Task', { 
title: Sequelize.STRING 
33; 


最 后 ， 设 置 一 个 hasMany 的 联合 : 


server.|s 


Task.belongsTo (Project) ; 
Project. Maan tas 


为 了 设置 联合 ，Sequelize 会 处 理 构 建 响应 的 列 、 主 键 以 及 索引 的 任务 。 


belongsTo 联 合意 味 着 每 个 Task 都 有 一 个 指向 它 所 属 项 目的 字段 。 另 外 ， 每 个 任务 模型 
都 会 有 一 个 名 为 getProject 的 方法 来 获取 其 所 属 的 项 目 。 


对 于 hasMany 而 言 ， 调 用 find 查 询 到 项 目 后 ， 它 们 都 会 有 一 个 名 为 getTasks 的 方法 来 获 
取 项 目 中 的 任务 。 

除 此 之 外 ，sequelize 还 支持 另 一 种 关系 : hasone。 不 过 本 例 中 用 不 到 这 种 联合 ， 它 与 
belongsTo 是 相对 的 。 


最 后 ， 我 们 要 确保 schema 都 同步 到 数据 库 中 了 ， 并 且 不 需要 手动 运行 CREATE TABLE 命 今 


fée 
« 同步 
*/ 


sequelize.sync(); 


在 开发 阶段 ， 我 们 会 经 常 对 数据 库 表 做 修改 操作 。 因 此 ， 我 们 可 以 在 调用 sync 方 法 时 ， 
传递 一 个 {force: true} 参 数 来 让 sequelize 始 终 先 删除 已 有 的 表 ， 再 重新 创建 ， 以 确保 数据 
变化 总 能 同步 到 数据 库 中 。 


server. js 


sequelize.sync(); 
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创建 数据 
对 于 项 目 和 任务 列表 ， 我 们 都 需要 在 表单 提交 时 ， 绑 定 一 个 jQuery 的 监听 器 。 
当 发 送 Ajax 调用 时 ， 我 们 希望 返回 的 是 JSON 格 式 的 模型 实例 数据 。 
[251 > 获取 数据 后 ， 我 们 就 将 其 添加 到 DOM 中 。 
在 这 之 前 ， 我 们 需要 添加 一 个 static 中 间 件 来 托管 public/js 目 录 (也 需要 创建 好 ) 。 
为 还 需要 使 用 jQuery 来 POST 数 据 ， 所 以 还 需要 bodyParser 中 间 件 。 





server.|s 
/* * 
* 中 间 件 


ef 


app.use(express.static(__dirname + '/public')); 
app.use(express.bodyParser()); 





public/js/main.js 
$(function () { 
$('form').submit (function (ev) ( 
ev.preventDefault(); 
var form - $(this); 
$.ajax({ 
url: form.attr('action') 
, type: 'POST' 
, data: form.serialize() 
, success: function (obj) { 
var el = $('«li»'); 
if ($('#projects-list').length) { 
el 
.append($('«a»').attr('href', '/project/' + obj.id 
+ '/tasks').text(obj.title + ' ')) 
.append($('«a»').attr('href', '/project/' + obj.id) 


.attr('class', 'delete').text('x')); 
) else ( 
el 
.append($('«span»').text(obj.title + ' ')) 
.append(S$('«a»').attr('href', '/task/' + obj.id) 
.attr('class', 'delete').text('x')); 
} 


$('ul').append(el); 


)); 
form.find('input').val(''); // clear the input 
3; 
); 


一 一 -一 
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代码 很 简单 。 捕 获 到 网 站 中 所 有 的 表单 提交 ， 并 利用 Ajax 的 方式 来 提交 : 
1， 捕 获 表 单 提交 。 


2. 通过 调用 preventDefault 方 法 来 阻止 默认 行为 。 也 就 是 说 ， 阻 止 浏览 器 试图 自动 <22] 
POST 表单 ， 因 为 我 们 想 要 用 Ajax 的 方式 来 提交 。 


3， 调 用 jQuery 的 $ .ajax 方法 来 提交 一 个 POST 请 求 ， 同 时 将 表单 数据 序列 化 成 查询 字符 
串 发 送 过 去 ( 通过 form. serialize 序 列 化 数据 ， 并 将 其 作为 aata 属 性 值 ) 。 


JSON 数 据 返 回 后 ， 我 们 重新 构造 该 数据 项 ， 并 将 其 添加 到 项 目 列表 或 者 任务 列表 中 。 如 
果 该 数据 项 是 项 目 ， 那 么 我 们 将 其 链接 添加 到 任务 列表 中 ， 同 时 再 添加 一 个 删除 链接 。 若 是 任 
务 ， 则 简单 地 添加 一 个 span 和 删除 链接 。 


现在 我 们 来 实现 Express 应 用 中 的 .post 路 由 。 这 里 我 们 使 用 模型 上 的 .build 方法 : 
server.|s | 


jee 
* 创建 项 目 路 由 
wy 


app.post('/projects', function (req, res, next) { 
Project .build(req.body) .save() 
.Success (function (obj) ( 
res.send(obj); 
}) 
. .error (next) 


}); 


jee 
* 为 项 目 添加 任务 


/ 


app.post('/project/:id/tasks', function (req, res, next) { 

res.body.ProjectId - req.params.id; 

Task.build(req.body).save() 
.success(function (obj) ( 
res.send(obj); 
)) 

-error (next) 

)); 





需要 记 住 很 重要 的 一 点 : 像 本 例 这 样 ， 如 果 用 户 可 以 设置 数据 库 中 的 字段 ， 并 且 没有 安全 
隐患 的 情况 下 ， 我 们 只 需 传 递 整个 请 求 体 即 可 ( 如 : 传递 rea.body ) 。 哪 怕 我 们 在 表单 中 只 
创建 了 一 些 输 入 项 ,但 是 不 要 忘记 ， 用 户 是 可 以 手动 伪造 任意 请 求 类 型 的 。 


238 PARTIV > 数据 库 


[253 > 如 第 9 章 中 介绍 的 ， 在 Express 中 使 用 res . send 方 法 可 以 很 容易 地 发 送 JSON 数 据 。 


如 下 所 示 ， 当 调用 模型 实例 上 的 . save 方 法 时 ，sequelize 会 分 发 一 个 success 事 件 并 传递 构 
建 好 的 对 象 ， 或 者 一 个 failure 事 件 并 传递 一 个 错误 对 象 。 在 sequelize 中 ， 如 下 代码 是 有 效 的 : 


Task.build(req.body).save() 
.on('success', function (obj) ( 
res.send(obj); 
}) 
.on('failure', next) 


可 以 使 用 success 和 ezrroz 方 法 来 更 容易 地 添加 事件 处 理 器 : 


Task. build(req.body) .save() 
.success(function (obj) ( 
res.send(obj); 
}) 


.error (next) 


注意 了 ， 为 了 确保 任务 和 项 目 之 前 的 关系 能 够 保留 ， 我 们 在 使 用 Task.builq 创 建 任 务 
时 ， 在 Task 对 象 上 添加 了 ProjectIqd 字 段 。 回 过 头 来 ， 当 我 们 在 模型 上 设置 了 belongsTo 
关系 后 ，sequelize 会 自动 在 schema 定 义 中 添加 ProjectId 字 段 。 


获取 数据 
每 个 sequelize 模 型 都 有 简单 的 方法 可 以 获取 指定 数据 表 中 单个 或 多 个 实例 。 
调用 Model#find 方 法 时 ， 可 以 直接 提供 一 个 主键 ， 并 监听 success 和 failure 事 件 : 


/** 
* 首页 路 由 
ef 


app.get('/', function (req, res, next) { 
Project.findAll() 
.success(function (projects) ( 
res.render('index', { projects: projects }); 
}) 
.error (next); 


)); 


由 于 此 前 建立 了 项 目 一 一 任务 的 联合 ,在 /project/:id/items 路 由 ,我 们 可 以 使 用 
getTasks 方 法 将 项 目 和 任务 都 传递 给 视图 层 : 





server.js 
app.get('/project/:id/tasks', function (req, res, next) { 
Project.find(Number(req.params.id)) 


.success (function (project) ( 
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project.getTasks().on('success', function (tasks) { 


res.render('tasks', { project: project, tasks: tasks }); 
}) 

}) 

.error (next) 


)); 


另外 ， 还 要 注意 的 是 ， 当 使 用 模型 实例 的 fino 方 法 时 ， 需 要 将 参数 转化 为 Number 类 型 。 
这 很 重要 ， 因 为 这 样 sequelize 才 能 知道 这 里 是 用 主键 去 查询 。 


接 下 来 ， 我 们 实现 剩 下 的 路 由 : 删除 项 目 和 删除 任务 。 


删除 数据 
接 下 来 ,我 们 利用 事件 委派 来 捕获 所 有 delete 类 的 链接 ， 并 发 送 DELETE 请 求 。 将 如 下 
代码 添加 到 $ (form) . submit 处 理 器 中 : 


public/js/main.js 
$('ul').delegate('a.delete', 'click', function (ev) { 
ev.preventDefault () ; 
var li = $(this).closest('li'); 
$.ajax({ 
url: $(this).attr('href') 
, type: 'DELETE' 
, success: function () { 
li.remove(); 
) 
)); 
); 


jQuery 的 delegate 方 法 允许 捕获 任意 包含 了 delete 类 的 超 链 接 ， 不 管 它 是 本 来 就 在 DOM 
中 的 还 是 后 台 动 态 加 进去 的 。 
注意 ， 在 点 击 了 含有 delete 类 的 超 链接 后 ， 我 们 查找 它 的 父 元 素 1 诗 ， 并 在 Ajax 请 求 成 功 
后 ， 将 其 删除 。 ， 
接着 ， 定 义 删 除 路 由 : 25] 


/wx 


* 删除 项 目 路 由 
*/ 


app.del('/project/:id', function (req, res, next) { 
Project. find(Number (req.params.id)).success(function (proj) { 
proj .destroy() 
.Success(function () ( 
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res.send(200); 
}) 
.error (néxt) ; 
}) .error (next); 
3); 


/I** 
* 删除 任务 路 由 
$y 


app.del('/task/:id', function (req, res, next) { 
Task. find (Number (req.params.id)).success(function (task) { 
task.destroy() 
.success(function () ( 
res.send(200); 
}) 
-error (next) 
}) .error (next); 
n: 


如 上 述 代 码 所 示 ， 首 先 获取 任务 或 者 项 目的 实例 ， 然 后 ， 调 用 destroy 将 其 删除 。 当 
destroy 指 令 成 功 后 ， 发 送 200 状 态 码 给 浏览 器 。 


同样 的 ， 要 想 修改 获取 到 的 数据 项 的 属性 ， 可 以 调用 updateAttributes。 下 述 代码 修 
改 指定 任务 实例 的 标题 : 


task.updateAttributes ({ 
title: 'a new title' 
)); 


图 13-5 展 示 了 完整 的 应 用 。 可 以 浏览 项 目 和 任务 ， 异步 地 对 它们 进行 添加 和 删除 。 








eoe 





Tasks for project New project 
E 






图 13-5: 为 某 个 项 目 创建 一 个 新 任务 


完整 地 完成 应 用 
sequelize 还 有 许多 功能 。 就 像 Mongoose 操 作 MongoDB 那 样 ，Sequelize 可 以 在 MySQL 和 模 
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型 数据 之 间 添 加 一 层 验证 层 ， 除了 定义 类 型 之 外 ， 这 个 功能 也 非常 有 用 。 

在 模型 中 定义 字段 时 ， 可 以 通过 传递 validate 选 项 来 设置 验证 机 制 。 类 型 则 定义 在 
type 中 。 

比如 ， 要 想 任务 标题 只 允许 大 写字 母 ， 那 么 模型 定义 可 以 采用 如 下 方式 : 


var Task = sequelize.define('Task', { 
title: { type: Sequelize.STRING, isUppercase: true } 
)); 


要 设置 自 定义 验证 ， 只 需 传 递 任意 的 函数 名 和 验证 函数 。 要 想 查 看 Sequelize 自 带 的 完整 验 
证 函数 列表 ， 可 以 前 往 其 官方 文档 查看 : http://sequelizejs.com/?active=validations#validations。 


还 可 以 通过 自 定义 的 类 和 实例 方法 来 扩展 模型 : 


var Task = sequelize.define('Task', { 
title: { type: Sequelize.STRING, isUppercase: true } 
, ClassMethods: { 
staticMethod: function() {} 
} 
, instanceMethods: { 
instanceMethod: function() {} 
} 
+); 


上 述 例子 中 的 staticMethod 方 法 可 以 通过 如 下 方式 进行 调用 : = 


Task.staticMethod() 


instanceMethod 则 可 以 在 查询 到 的 实例 上 使 用 : 


Task.find(4).success(function (task) { 
task.instanceMethod(); 
}); 


小 结 

MySQL 仍 旧 是 最 流行 、 最 可 靠 的 开源 数据 库 之 一 。 无 论 新 的 趋势 如 何 ， 考 良 置 疑 ， 
MySQL 依 然 是 构建 各 类 应 用 不 错 的 选择 。 

本 章 介绍 了 一 个 优秀 的 MySQL Node.js 驱 动 器 。 不 过 ， 需 要 手动 书写 SQL 语句 来 创建 数据 
库 、 表 才能 查询 。 

对 于 开发 Web 应 用 ，ORM 通 常 是 一 种 非常 有 用 的 武器 。 在 本 章 第 二 个 例子 中 ， 得 益 于 
Sequelize， 我 们 无 须 再 手写 查询 语句 ， 而 是 可 以 直接 通过 模型 类 和 实例 来 操作 数据 了 。 


尽管 总 要 在 选择 正确 的 工具 这 件 事 情 上 面 多 加 谨慎 ， 不过， 现在 你 应 该 懂得 了 在 Node.ijs 
中 什么 样 的 项 目 适合 使 用 MySQL。 


CHAPTER 


Redis 


既然 你 已 经 学 会 了 如 何 通过 Node.js 来 使 用 两 大 主流 数据 库 一 一 MongoDB 和 MySQL， 那 么 
接 下 来 是 时 候 介绍 Redis 了 。 

Redis 是 一 种 数据 库 ， 不 过 更 准确 地 来 说 ， 它 更 像 一 台 结构 化 的 数据 服务 器 ， 从 定义 上 来 
说 相 比 MySQL 更 接近 MongoDB。 

和 操作 表 中 的 行 或 者 集合 中 的 文档 不 同 ， 在 Redis 中 是 通过 键 来 访问 数据 的 。 因 此 ， 可 以 
将 Redis 想 象 成 是 通过 如 下 所 示 的 JavaScript 对 象 的 方式 来 存储 数据 的 : 


{ 
'key': ‘some value’ 
, 'key.2': ‘some other value' 


) 

不 过 ， 正 因为 它 是 一 个 结构 化 的 数据 服务 器 ， 能 存储 的 值 自 然 不 仅仅 是 简单 的 字符 串 。 如 
下 都 是 Redis 支 持 的 数据 类 型 : 

= 字符 串 〈string ) 

* 列表 (list) 

= 数据 集 (set) 
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* df (hash) 

= 有 序数 据 集 (sorted set ) 

然而 ，Redis 和 MongoDB 最 显著 的 不 同 点 就 是 ，Redis 中 的 文档 结构 总 是 扁平 的 。 举 例 来 
说 ， 即 使 一 个 键 包含 类 似 哈 希 的 JavaScript 对 象 ， 却 不 能 包含 像 MongoDB 支 持 的 那 种 内 套 的 数 
据 结构 。 

另 一 个 不 同 点 在 于 持久 化 数据 方式 的 不 同 。Redis 设 计 的 初衷 是 内 存 存储 ， 搭 配 可 配置 的 
磁盘 持久 化 思路 ， 所 以 速度 很 快 。 有 一 点 很 重要 ， 需 要 记 住 : 持久 化 到 磁盘 是 很 重要 的 ， 因 为 
任何 存储 在 内 存 中 的 东西 都 是 不 稳定 的 ， 而 且 会 随 着 系统 崩溃 或 者 重启 而 受到 影响 。 


这 就 意味 着 ， 对 于 敏感 的 数据 系统 而 言 (如 处 理 金融 交易 ) ， 在 开发 之 前 ， 使 用 以 及 配置 
Redis 都 要 非常 仔细 。 尽 管 Redis 的 数据 集 ( 我们 所 操作 的 所 有 数据 ) 存储 在 内 存 中 ， 但 是 它 有 
多 重 策略 来 将 数据 备份 到 磁盘 中 。 问 题 就 在 于 ， 其 默认 的 配置 和 行为 并 不 像 MySQL 那 样 非常 
适合 数据 敏感 的 系统 。 这 就 是 Redis 被 冠 以 “仅仅 算是 一 种 数据 库 ， 但 却 不 怎么 耐用 ”的 原因 
To 

如 果 你 是 第 一 次 尝试 部 署 Redis， 我 建议 你 先 看 看 官网 提供 的 几 种 不 同 持久 化 的 选择 : 
http://redis.io/topics/persistence。 总 的 来 说 ， 你 可 以 把 Redis 看 作 是 简单 、 庞 大 、 扁 平 ( 键 一 值 ) 
的 JavaScript 对 象 ， 其 中 值 可 以 是 特殊 的 数据 类 型 ( 哈 希 、 数 据 集 、 字 符 串 等 ) ， 它 是 为 高 速 
读 写 数据 孕育 而 生 的 ( 所 有 数据 都 存储 在 内 存 中 ) 。 数 据 写 入 后 的 安全 级 别 也 是 可 配置 的 ,但 
是 ， 对 某 类 系统 而 言 ， 它 并 非 是 一 个 好 的 选择 。 


安装 Redis 

Redis 官 方 以 tar 包 的 形式 发 布 ， 包含 所 有 源 代码 ， 支 持 Mac OS X 和 Linux。 如 果 你 想 自己 
编译 ， 可 以 直接 通过 http://redis.io/download 来 下 载 最 新 的 稳定 版 本 。 

而 对 于 Mac 来 说 ， 最 简单 的 安装 Redis 的 方式 是 通过 homebrew: 

$ brew install redis 

或 者 通过 ports: 

$ sudo port install redis 

与 从 源 代码 安装 不 同 ， 这 两 个 包 管理 器 会 在 载 入 完毕 后 ， 自 动 安 装 。 通 过 如 下 命令 可 以 运 
行 Redis 服 务 器 : 


$ nohup redis-server & 


对 于 Windows， 也 有 非 官 方 但 维护 得 很 好 的 版 本 。 通 过 上 面 的 URL 来 查看 最 新 文档 了 解 对 
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于 Windows 的 支持 情况 。 


Redis 查 询 语言 
要 开始 学 习 Redis 查 询 语言 ( 换 句 话 说， 就 好 比 是 Redis 中 的 SQL ) ， 首 先 确 保 服 务 器 正常 
运行 ， 随 后 执行 如 下 命令 : 


$ redis-cli 


和 执行 hode 一 样 ，redis-cli 其 实 就 是 和 Redis 服 务 器 之 间 建 立 了 telnet 连 接 。 换 句 话 
说 ， 当 建立 到 Redis 的 TCP 连 接 时 ， 接 下 来 要 执行 的 命令 和 Node 客 户 端 执行 的 几乎 是 一 样 的 。 


第 一 个 要 执行 的 命令 是 KEYS。 在 Redis 中 ,命令 都 是 大 小 写 不 敏感 的 ， 不 过 通常 都 约定 了 
用 大 写 方 式 。 

和 函数 调用 一 样 ， 命 令 可 以 接收 任意 数量 的 参数 。 如 果 执 行 KEYS 时 不 添加 任何 参数 ， 
Redis 就 会 抛 出 如 下 错误 : 


redis 127.0.0.1:6379> KEYS 
(error) ERR wrong number of arguments for 'keys' command 


KEYS 接 收 一 个 匹配 键 的 模式 ， 并 返回 匹配 到 的 键 。* 表 示 匹 配 所 有 键 : 


redis 127.0.0.1:6379> KEYS * 
(empty list or set) 


由 于 Redis 刚 装 好 ， 所 以 上 述 代码 返回 空 。 
现在 我 们 来 用 SET 命 令 将 一 个 字符 串 赋值 给 某 个 键 。Redis 会 返回 OK: 


redis 127.0.0.1:6379> SET my.key test 
OK 


运行 GET my . key 会 返回 刚刚 保存 的 值 : 


redis 127.0.0.1:6379> GET my.key 
"test" 


再 次 执行 KEYS * 就 会 返回 新 的 键 : 


redis 127.0.0.1:6379> KEYS * 
1) "my.key" 


绝 大 部 分 Redis 指 令 都 是 依赖 于 数据 类 型 的 。 使 用 GET 和 SET 可 以 操作 字符 串 ， 但 是 ， 使 用 
GET 却 不 能 获取 哈 希 类 型 的 值 。 


数据 类 型 
Redis 简 单 的 设计 带 来 的 最 基本 的 好 处 之 一 就 是 开发 者 可 以 很 容易 地 预测 出 性 能 。 数 据 库 
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并 不 是 一 个 黑 盒 ， 而 是 一 个 简单 的 进程 ， 它 将 某 些 已 知 的 数据 结构 存储 到 内 容 中 ， 让 其 他 程序 
通过 简单 的 协议 就 能 够 获取 到 。 

如 果 你 在 Redis 官 方 文档 手册 中 查看 HEXISTS 命 令 ， 你 就 会 发 现 其 中 有 一 部 分 是 关于 时 间 
复杂 度 的 。 


HEXISTS 命 令 的 时 间 复 杂 度 是 O(1)， 也 就 是 固定 的 时 长 。 这 就 意味 着 ,不管 数据 集 有 多 
大 ， 执 行 HEXISTS 命 令 总 是 需要 这 些 时 间 。 


如 果 查 看 SMEMBERS， 就 会 发 现 它 的 时 间 复 杂 度 是 O(n)， 也 就 是 线性 的 时 长 ， 所 需 时 间 是 
随 着 数据 集 的 大 小 而 改变 的 。 这 就 意味 着 Redis 完 成 该 指令 所 需 的 时 间 直 接 取决 于 数据 有 多 少 
量 。 


和 由 于 Redis 的 对 象 模型 大 致 就 是 一 个 大 的 扁平 的 JSON 对 象 ， 所 以 ， 理 解 不 同 数据 类 型 最 简 
单 的 方式 就 是 把 它们 想象 成 JavaScript 中 的 数据 类 型 。 对 于 每 一 种 数据 类 型 ， 下 面 都 会 介绍 与 
之 类 似 的 JS 世界 中 的 类 型 。 


TE 
Redis 中 的 字符 串 类 似 于 JavaScript 中 的 Number 和 String。 
除了 使 用 SET 和 和 GET 外， 还 可 以 对 数字 进行 递增 和 递减: 


redis 127.0.0.1:6379> SET online.users 0 
OK 

redis 127.0.0.1:6379> INCR online.users 

(integer) 1 

redis 127.0.0.1:6379> INCR online.users 


(integer) 2 


x 


De s. 


在 Redis 中 ， 哈 希 类似 于 子 对 象 。 不 过 和 MongoDB 不 同 的 是 ， 这 些 子 对 象 只 能 局 限于 字符 
串 形 式 的 键 和 值 。 


要 在 Redis 中 存储 用 户 信息 ， 如 下 所 示 : 


{ 


“name": "Guillermo" 
, "last": "Rauch" 
, "age": "21" 


) 
由 于 键 和 值 都 是 字符 串 〈 或 者 数字 ) ， 所 以 ， 用 哈 希 来 描述 这 种 数据 结构 最 合适 不 过 了 。 


正如 此 前 所 述 ， 在 Redis 中 ， 大 对 象 中 的 所 有 数据 都 是 通过 唯一 的 键 来 获取 的 。 要 存储 用 
户 信息 ， 我 们 需要 将 用 户 ID 作为 键 的 一 部 分 来 唯一 确定 存储 的 值 。Redis 数 据 库存 储 的 数据 如 
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下 所 示 : 


{ 
"profile:1": ( name: "Guillermo", "last": "Rauch", . . . } 


, "profile:2": ( name: "Tobi", "last": "Rauch", . . . } 
) 


上 述 例子 中 是 否 使 用 冒号 C) 取决 于 你 自己 。 你 也 可 以 使 用 点 、 下 画 线 或 者 干脆 不 用 。 
只 要 保证 在 操作 文档 时 每 个 键 都 能 唯一 ， 避 免 冲突 ， 同 时 键 名 又 包含 了 足够 多 的 信息 ， 能 够 从 
应 用 层面 简单 地 获取 到 ， 就 可 以 了 。 


操作 哈 希 的 基本 命令 是 HSET: 


redis 127.0.0.1:6379> HSET profile.1 name Guillermo 


(integer) 1 
这 个 命令 就 等 于 在 JavaScript 中 设置 一 个 键 : 


obj['profile.1'].name = 'Guillermo'; 
要 获取 一 个 指定 哈 希 中 所 有 的 键 和 值 ， 可 以 使 用 HGETRALL， 并 提供 一 个 键 名 : 


redis 127.0.0.1:6379> HGETALL profile.1 
1) "name" 
2) "Guillermo" 


Redis 会 返回 一 个 包含 了 修改 过 的 键 和 值 的 列表 : 


redis 127.0.0.1:6379> HSET profile.1 last Rauch 
(integer) 1 

redis 127.0.0.1:6379> HGETALL profile.1 

1) "name" 

2) "Guillermo" 

3) "last" 

4) "Rauch" 


要 在 哈 硕 中 删除 一 个 键 ， 可 以 调用 HDEL : 


redis 127.0.0.1:6379> HSET profile.1 programmer 1 
(integer) 1 

redis 127.0.0.1:6379> HGETALL profile.1 

1) "name" 

2) "Guillermo" 

3) *1àst" 

4) "Rauch" 

5) "programmer" 

Gy "X* 

redis 127.0.0.1:6379» HDEL profile.1 programmer 
(integer) 1 

redis 127.0.0.1:6379» HGETALL profile.i 

1) "name" 

2) "Guillermo" 
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3) "last" 
4) "Rauch" 


在 JavaScript 中 ， 上 述 指令 就 等 同 于 在 哈 希 中 使 用 了 delete 操 作 符 : 
delete obj['profile.1'].programmer 


还 可 以 使 用 HEXISTS 来 检查 指定 的 字段 是 否 存在 : 


redis 127.0.0.1:6379> HEXISTS profile.1 programmer 


(integer) 0 
上 述 命令 等 同 于 检查 某 个 值 是 否 不 等 于 undefined: 


'undefined' != typeof obj['profile.1'].programmer 


列表 
Redis 中 的 列表 就 等 同 于 JavaScript 中 的 字符 串 数组 。 


对 于 列表 ， 在 Redis 中 有 两 个 基本 的 操作 命令 是 RPUSH ( push 到 右 侧 ， 也 就 是 列表 的 尾 
端 ) 和 LPUSH (push 到 左 侧 ， 也 就 是 列表 的 顶端 ) 。 


操作 列表 和 操作 哈 希 类 似 : 


redis 127.0.0.1:6379» RPUSH profile.1.jobs "job 1" 
(integer) 1 
redis 127.0.0.1:6379» RPUSH profile.1.jobs "job 2" 


(integer) 2 


然后 可 以 获取 指定 返回 的 数组 : 

redis 127.0.0.1:6379» LRANGE profile.1.jobs 0 -1 
1) “job 1" 

2) "job 2" 


LPUSH 也 类 似 : 


redis 127.0.0.1:6379» LPUSH profile.1.jobs "job 0" 
(integer) 3 
redis 127.0.0.1:6379» LRANGE profile.1.jobs 0 -1 


1) "job 0" 
2) "job 1" 
3) “job 2" 


RPUSH 等 同 于 在 JavaScript 中 push 一 个 元 素 到 数组 中 : 
obj['profile.1.jobs'].push('job 2'); 
LPUSH 等 同 于 unshift: 


obj ['profile.1.jobs'].unshift('job 2'); 
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LRANGE 命 令 返 回 一 个 在 列表 中 指定 范围 的 元 素 。 它 和 JavaScript 中 数组 的 sl1ice 类 似 但 不 
完全 一 样 。 特 别 是 ， 当 第 二 个 参数 是 -1 时 ， 它 会 返回 列表 中 所 有 的 值 。 


数据 集 

数据 集 处 于 列表 和 哈 希 之 间 。 它 拥有 哈 希 的 属性 ， 即 数据 集中 的 每 一 项 (或 者 喻 希 中 的 
键 ) 都 是 唯一 不 重复 的 。 既 然 是 等 同 于 哈 希 中 的 键 ， 操 作 数据 集中 的 元 素 都 只 需要 固定 时 长 
(也 就 是 说 ， 无 论 数据 集 多 大 ， 删 除 、 添 加 、 查 找 数据 集中 的 元 素 都 只 需 同 等 的 时 间 ) 。 


不 像 哈 希 但 类 似 列表 的 是 ， 数 据 集 保存 的 是 单个 值 (字符 串 ) ， 没 有 键 。 不 过 ， 数 据 集 还 
有 它 专 属 的 有 意思 的 特性 。Redis 允 许 在 数据 集 、 联 合 (union) 、 获 取 到 的 随机 元 素 等 之 间 做 
交集 操作 。 


要 添加 一 个 元 素 到 数据 集中 ， 可 以 使 用 SADD: 


redis 127.0.0.1:6379> SADD myset "a member" 


(integer) 1 


获取 数据 集 的 所 有 元 素 ， 可 以 使 用 SMEMBERS : 


redis 127.0.0.1:6379> SMEMBERS myset 
1) "a member" 


以 相同 值 再 次 调用 SADD 不 会 发 生 任何 事情 : 


redis 127.0.0.1:6379> SADD myset "a member" 
(integer) 0 
redis 127.0.0.1:6379> SMEMBERS myset 


1) "a member" 


移 除数 据 集中 的 某 个 元 素 ， 可 以 使 用 SREM; 


redis 127.0.0.1:6379> SREM myset "a member" 
(integer) 1 


序数 据 集 
有 序数 据 集 拥有 所 有 数据 集 的 特性 ， 不 过 ， 顾 名 思 义 ， 它 是 有 序 的 。 在 Redis 中 ,使 用 有 
序数 据 集 的 情况 较 少 ， 属 于 高 级 用 法 。 














Redis 和 Node 


既然 这 些 数据 结构 JavaScript 都 有 ( 或 者 可 以 很 容易 地 构建 出 来 ) ， 并 且 操 作 它们 也 不 需 
要 什么 协议 或 者 服务 器 ， 那 么 Redis 的 作用 究竟 在 哪里 呢 ? 


其 中 有 一 个 原因 就 是 当 关闭 Node 进 程 后 ， 所 有 在 内 存 中 的 数据 都 会 消失 。 
在 第 9 章 中 ,我们 介绍 过 如 何 使 用 Redis 来 存储 用 户 的 session 数 据 。 要 是 把 这 些 数据 存储 在 
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Node 进 程 中 ， 会 有 两 大 缺点 ， 如 下 所 示 。 
。 应 用 程序 永远 都 无 法 享受 到 多 线程 带 来 的 好 处 。 随 着 应 用 程序 负载 不 断 增 长 ， 单 进程 
无 法 承受 所 有 的 负载 ， 我 们 需要 将 应 用 程序 扩展 到 多 进程 或 者 多 台 计算 机 。 
267 " 每 次 重启 应 用 都 会 丢失 session 数 据 : 比如 ， 在 部 署 新 代码 的 时 候 总 是 需要 重启 的 。 
Redis 还 有 许多 其 他 非常 重要 的 好 处 ， 比 如 : 多 种 编程 语言 间 的 协同 、 持 久 性 以 及 其 他 一 
些 通 过 书写 完整 的 数据 存储 方案 才能 获取 的 特性 。 


使 用 node-redis 实 现 一 个 社交 图 谱 
作为 一 个 使 用 Redis 和 Node 的 示例 程序 ， 我 们 可 以 通过 使 用 数据 集 和 交集 的 强大 功能 ， 来 
构建 一 个 关注 ( follows ) 415327. (followers ) 的 社交 图 谱 ， 和 Twitter 非 常 类 似 。 


初始 化 应 用 
我 们 选择 一 个 名 为 node_redis ( https://github.com/ mranney/node redis ) 项 目 作 为 Redis 客 户 
端 ， 其 NPM 的 项 目 名 就 吊 redis: 


package.json 
{ 
"name": "sample-social-graph" 
1 “version": *0.0.1* 
, “Gependencies": { 
"redis*. *0,.7.1" 


) 








连接 redis 

node-redis 遵 循 了 和 我 们 在 第 13 章 中 介绍 的 MySQL 客 户 端 类 似 的 设计 。 

首先 ， 通过 require 来 引入 该 模块 ， 然 后 通过 createclient 来 初始 化 客户 端 : 
" 

* 模块 依赖 

*/ 

var redis - require('redis') 

yee 
* 创建 客户 端 


var client = redis.createClient(); 
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客户 端 将 所 有 的 Redis 命 令 都 以 函数 的 方式 提供 出 来 。 比 如 ， 要 使 用 SET， 可 以 这 样 : 


client.set('my key', 'my value', function (err) { 
KE. xo 
)): 


其 他 如 SMEMBERS 、HEXISTS 命 令 等 也 是 相同 的 使 用 方式 。 


定义 模型 
首先 ， 我 们 需要 为 每 个 用 户 关注 的 人 和 粉丝 创建 不 同 的 Redis 数 据 集 ， 其 中 ID 作为 键 的 一 
部 分 : 


user:<id>:follows 


user:<id>: followers 
当 某 个 用 户 ( id "1") 关注 了 另 一 个 用 户 (id "2") 时 ， 我 们 需要 执行 如 下 操作 : 


- Add user id "2" to the user:1: follows 


- Add user id "1" to the user:2:followers 


除 此 之 外 ， 我 们 将 用 户 信息 存储 在 哈 硕 中 : 
user:<id>:data 


接 下 来 ， 从 定义 基本 的 模型 开始 : 


/** 
* 用 户 模型 


function User (id, data) { 
this.id = id; 
this.data = data; 

} 


每 个 User 实 例 都 会 包含 一 个 1d， 来 标识 该 用 户 及 其 数据 。 
我 们 也 可 以 提供 一 个 静态 方法 find， 用 来 从 Redis 查 询 结 果 中 构建 一 个 User 实 例 : 


User.find = function (id, fn) { 
client.hgetall('user:' + id + ':data', function (err, obj) { 
if (err) return fn(err); 
fn(null, new User(id, obj)); 
)); 
}; 


创建 及 修改 用 户 信息 


模型 需要 有 查询 一 个 用 户 、 修 改 该 用 户 的 信息 以 及 重新 保存 到 Redis 的 能 力 。 我 们 需要 能 
够 运行 new User， 设 置 一 些 数据 ， 然 后 将 其 保存 到 Redis 中 。 
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幸运 的 是 ， 通 过 Node 来 操作 哈 希 要 比 在 Redis 命 令 行 中 更 简单 。hgetal1 和 hmset 函 数 可 
以 直接 操作 JavaScript 原 生 对 象 ， 这 就 是 为 什么 操作 起 来 更 容易 的 原因 : 


client.hmset('somehash', { a: 'key', another: 'key' }); 
上 述 代 码 等 同 于 如 下 所 示 的 在 Redis 命 令 行 (CLI) 执行 的 命令 : 
HMSET somehash "key" "value" "anotherkey" "anothervalue" 


当 通过 hgetal1 获 取 到 数据 后 ， 回 调 函数 中 的 第 二 个 参数 就 是 JavaScript 对 象 : 


client.hgetall('somehash', function (err, obj) { 
// obj.a == 'key' 
)); 


所 以 ， 我 们 可 以 给 模型 添加 一 个 save 方 法 ， 该 方法 执行 hmset 来 创建 和 修改 用 户 信息 : 


User.prototype.save = function (fn) { 
if (!this.id) { 
this.id = String (Math.random ()) .substr (3); 
} 


client.hmset('user:' + this.id + ':data', this.data, fn) 
}; 


定义 图 谱 方法 
对 于 一 个 指定 用 户 ， 我 们 需要 做 的 操作 是 : 关注 另 一 个 用 户 ， 以 及 取消 关注 另 一 个 用 户 。 


User.prototype.follow = function (user id, fn) { 


client.multi() 


.sadd('user:' + user id + ':followers', this.id) 
.sadd('user:' + this.id + ':follows', user id) 
.exec(fn); 


}; 


User.prototype.unfollow = function (user_id, fn) { 
client.multi() 
-srem('user:' + user id + ':followers', this.id) 
.srem('user:' + this.id + ':follows', user id) 
.exec(fn); 


}; 
注意 了 ， 和 此 前 的 例子 不 同 ， 这 一 次 调用 的 是 client .multi。 调 用 了 multi 就 意味 着 
告诉 Redis 客 户 端 ， 所 有 的 命令 都 必须 要 等 到 exec 执 行 后 才能 执行 ， 它 们 作为 事务 的 一 部 分 ， 
应 当 需 要 一 起 执行 。 
如 果 修 改 关 注 列 表 的 时 候 ， 发 生 了 某 些 事件 导致 了 粉丝 列表 修改 失败 ， 这 时 就 会 导致 数据 
的 不 一 致 。 所 以 ， 这 两 部 分 的 修改 需要 放 到 同一 个 事务 中 来 处 理 。 
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最 后 ， 还 需要 定义 两 个 获取 关注 的 人 和 粉丝 的 方法 : 


User.prototype.getFollowers = function (fn) { 
client.smembers('user:' + this.id + ':followers', fn); 


}; 


User.prototype.getFollows = function (fn) { 
client.smembers('user:' + this.id + ':follows', fn); 
pz 


计算 交集 

除了 关注 的 人 和 粉丝 之 外 ， 我 们 还 需要 计算 第 三 种 关系 : 朋友 。 

我 们 可 以 说 两 者 互相 关注 的 是 朋友 。 换 句 话 说， 如 果 某 个 用 户 的 ID 同时 出 现在 另 一 个 用 
户 的 关注 和 粉丝 列表 中 ,那么 他 们 就 是 朋友 。 

添加 一 个 getFriends 很 容易 ， 直 接 使 用 SINTER 命 令 来 计算 两 个 数据 集 的 交集 即 可 : 


User .prototype.getFriends = function (fn) { 
client.sinter('user:' + this.id + ':follows', 'user:' + this.id + ':followers', 
fn); 

); 


测试 
要 测试 模型 ， 我 们 需要 创建 一 些 对 Web 应 用 来 说 有 代表 性 的 用 户 数据 。 


第 一 步 要 做 的 就 是 为 了 更 好 地 重用 ， 需 要 把 此 前 我 们 书写 的 模型 代码 放 到 单独 的 文件 中 ， 
这 样 就 可 以 简单 地 通过 require 来 引 和 了。 注意 了 ， 我 添加 了 一 行 nodule .exports 代 码 : 


model.js 


/** 
* 模块 依赖 
i 


var redis = require('redis') 


/** 
* 模块 导出 
<27] 


mođule.exports = User; 


[** 


Gee ze 
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Ry 
var client = redis.createClient(); 


[** 


* 用 户 模型 
*/ 


function User (id, data) { 
this.id = id; 
this.data = data; 


User.prototype.save = function (fn) { 
if (!this.id) ( 
this.id - String(Math.random()).substr(3 


client.hmset('user:' + this.id + ':data', 
}; 


) ， 


this.data, fn) 


User.prototype.follow = function (user_id, fn) { 


client .multi() 
.sadd('user:' + user id + ':followers', 


this.id) 


.sadd('user:' + this.id + ':follows', user id) 


.exec(fn); 
}; 


User.prototype.unfollow = function (user_id, 
client.multi() 
.srem('user:' + user id + ':followers', 


fn) ( 


this.id) 


.srem('user:' + this.id + ':follows', user id) 


.exec(fn); 
}; 


User.prototype.getFollowers = function (fn) 


{ 


client.smembers('user:' + this.id + ':followers', fn); 


}; 


User.prototype.getFollorws = function (fn) { 


client.smembers('user:' + this.id + ':follows', fn); 


}; 
User.prototype.getFriends = function (fn) { 
client.sinter('user:' + this.id + ':follows', 'user:' + this.id + 
fn); 
3 


User.find - function (id, fn) ( 


client.hgetall('user:' + id + ':data', function (err, 


obj) 


( 


‘:followers', 
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if (err) return fn(err); 
fn(null, new User(id, obj)); 
We 
}; 


确保 要 运行 npm install redis 来 安装 本 例 依赖 的 唯一 模块 ， 与 此 同时 通过 运行 
redis-cli 来 确保 Redis 服 务 器 已 经 运行 了 。 
接 下 来 我们 需要 创建 一 个 测试 脚本 并 引入 模型 。 在 同一 目录 下 ， 创 建 一 个 test .js 文件 : 


test.js 


/[** 
* 模块 依赖 
*/ 


var User = require('./model') 





如 果 现在 通过 node test 执 行 上 述 文件 ， 你 会 发 现 它 的 进程 会 挂 在 那里 ， 不 会 自己 退 
出 。 这 是 因为 模型 正在 和 Redis 建 立 连接 。 


接着 ， 我 们 要 创建 一 些 测试 用 户 。 为 了 更 好 地 组 织 代 码 ， 避 免 过 多 的 舱 套 回调 函数 ， 我 们 
定义 一 个 create 方 法 ， 该 方法 接收 一 个 包含 email 和 用 户 数据 的 对 象 。 本 例 中 ，email 地 址 会 作 
为 唯一 的 id 存储 到 Redis 中 。 





test.js 


/** 
* 模块 依赖 
*/ 


var User - require('./model') 


/** 
* 创建 测试 用 户 
* 
var testUsers - ( 
'markéfacebook.com': { name: 'Mark Zuckerberg' } 
, 'bill@microsoft.com': { name: ‘Bill Gates’ ) 
, 'jeffeamazon.com': { name: 'Jeff Bezos' } 
, 'fredéfedex.com': ( name: 'Fred Smith' ) 
3 


/** 


* 用 于 创建 用 户 的 函数 
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*/ 


function create (users, fn) { 
var total = Object.keys(users) .length; 
for (var i in users) { 
(function (email, data) { 
var user = new User(email, data); 
user.save(function (err) { 
if (err) throw err; 
--total || fn(); 
}); 


}) (i, users[i]); 


} 


/** 
* 创建 测试 用 户 
*/ 


create(testUsers, function () { 
console.log('all users created'); 
process.exit(); 


}); 








这 个 时 候 运行 node test， 应 当 就 已 经 成 功 添加 了 四 个 用 户 。 可 以 使 用 redis-cli 来 检 
查 是 否 正确 : 


redis-cli 

redis 127.0.0.1:6379» KEYS * 

1) "user:fredGfedex.com:data" 

2) "user: jeffG@amazon.com:data" 

3) "“user:bill@microsoft.com:data" 

4) "user:mark@facebook.com:data" 

redis 127.0.0.1:6379» HGETALL "user: fred@fedex.com:data" 
1) "name" 

2) "Fred Smith" 


TERS, ERHGETALLM T WIUser.findpR CIS E HIE FER: 它 根据 id 获取 对 应 用 户 的 
数据 。 


274 为 了 避免 混淆 ， 每 次 执行 完 node test， 都 建议 将 Redis 数 据 库 清 空 以 确保 由 不 同 测试 用 
例 创 建 的 数据 不 会 相互 混淆 。 清 空 数据 库 可 以 使 用 如 下 命令 : 


redis-cli FLUSHALL 


至 此 ， 用 户 已 经 成 功 创建 好 了 ， 接 下 来 我 们 需要 根据 email 来 获取 User 对 象 ， 这 样 就 可 以 通 
过 此 前 在 模型 中 定义 的 方法 来 建立 用 户 之 间 的 关系 。 这 个 处 理 过 程 称 为 水 合 (hydration) , 
我 们 要 建立 一 个 hydqrate 方 法 ， 并 在 create 回 调 函 数 中 使 用 : 





test.js 


如 图 14-1 所 示 ， 若 再 次 运行 测试 脚本 ， 你 会 发 现 testUsers 对 象 包含 了 User 对 象 ( 该 对 


象 包 含 在 Usez 构 造 需 中 传递 的 id 和 data 属 性 ) 


ooo 


node test.js 
{ 'markefacebook. com": 
ame: ‘Mark Zuckerberg’ 
"bil l@microsoft.com' 
name: ‘Bill Gates' 
* jef f@amazon. com" : 


} }, 


"Jeff Bezos' } }, 
*fred@fedex.com': { id: 
Fred Smith' } } } 


*fred@fedex.com' , 





1 建 好 的 用 户 数据 


ES 
Y 
=p 
rr 
ID. 
R 
> 
a 
Xni 





水 合 后 ， 就 可 以 使 用 模型 上 多 种 不 同 的 方法 了 : 


test.js 
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在 图 14-2 中 ， 如 控制 台 输出 所 示 ， 它 展示 了 Redis 中 的 交集 操作 的 结果 


ADA 2. bash rs 
* node test.js 


'billémicrosoft.com' ] 


+ jeffed foll 
jeff's friends [ 'billémicrosoft.com' ] 





CHAPTER 14 。 Redis 


小 结 
在 我 看 来 Redis 是 最 重要 的 、 生 机 瞧 然 的 数据 库 之 一 ， 这 也 是 我 在 本 章 一 开始 花 笔墨 来 介 
绍 它 的 基本 技术 点 的 原因 。 


因为 它 就 像 是 结构 化 的 数据 服务 器 ， 既 可 以 用 作 普 通 的 数据 库 ， 也 可 作为 一 种 黏合 剂 来 协 
调 多 个 小 程序 。 

比如 ， 在 第 9 章 中 ， 我 们 介绍 了 如 何 使 用 connect-redis 来 当 重 启 Node 进 程 时 保持 
session 数 据 的 持久 化 。 当 然 了 ，Node 本 身 也 可 以 将 这 些 数 据 存储 在 内 存 中 ， 不 过 通过 将 数据 分 
离 到 另 一 个 进程 ， 并 通过 简单 的 TCP 协 议 来 连接 操作 ， 就 可 以 获得 灵活 独立 的 好 处 : 不 管 程序 
本 身 有 没有 运行 ， 数 据 都 在 那儿 。 


大 量程 序 和 Web 应 用 都 有 简单 的 数据 模型 ， 数 据 集 也 非常 适合 存储 在 内 存 中 。 对 于 这 些 使 
用 场景 ， 我 推荐 你 首先 考虑 Redis， 因 为 它 简单 、 可 靠 ， 而 且 通 过 Node.js 非 常 易 于 使 用 。 本 章 
中 的 示例 程序 就 是 一 个 很 好 的 例子 : 我 们 书写 了 一 个 完整 的 模型 ， 该 模型 仅 通过 使 用 Redis 驱 
动 器 就 包含 了 所 有 当今 社交 应 用 所 需 的 重要 功能 。 
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测试 
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CHAPTER 


代码 共 至 





在 本 书 介绍 部 分 ， 我 就 提 过 ，Node.js 最 重要 的 特点 之 一 就 是 : 它 所 使 用 的 语言 一 一 
JavaScript, FED Và ash E— 3c RERHITR a o 

尽管 现在 我 们 已 经 写 了 很 多 独立 的 JavaScript 代 码 ， 减 少 了 在 开发 Web 应 用 时 总 要 在 不 同 
语言 之 间 切 换 上 下 文 的 痛苦 。 我 们 还 没有 享受 到 一 次 编码 处 处 运行 的 好 处 。 


本 章 分 析 适 合 代码 共享 的 最 佳 用 例 ， 以 及 如 何 解决 常见 的 语言 兼容 性 问题 。 本 章 还 会 介 
绍 如 何 书写 模块 化 Node 代 码 的 最 佳 实践 ， 并 将 其 通过 browserbuild 编 译 后 在 浏览 器 中 直接 
运行 。 


什么 样 的 代码 可 以 共享 
回答 代码 是 否 可 以 在 浏览 器 和 服务 器 端 共 享 的 最 简单 的 方式 就 是 把 问题 拆 为 如 下 两 个 问 
题 : 
。 是 否 值得 在 两 个 环境 中 运行 同一 份 代码 ? 
* 代码 依赖 的 API 在 两 个 环境 中 是 否 都 有 ? 如 果 不 是 ， 那 么 是 否 能 够 很 容易 地 找到 替换 
它们 的 方法 〈 称 为 模拟 实现 法 ) 。 
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回答 第 一 个 问题 比较 简单 ， 答 案 本 身 取 决 于 程序 和 项 目 本 身 。 回 答 第 二 个 问题 就 有 点 困难 了 。 
在 第 2 章 中 ， 我 们 介绍 了 有 些 特定 的 和 JavaScript 有 关联 的 API 并 非 是 语言 的 一 部 分 ， 而 是 浏 


览 器 提供 的 标准 API。 例 如 : XMLHttpRequest, WebSocket, 、DOM、2d 画 布 API， 等 等 。 


尽管 Node.js 核 心 并 未 提供 XMLHttpRequest API, 但 是 我 们 可 以 通过 使 用 Node.js 的 HTTP 


客户 端 API 来 替代 。 在 NPM 有 个 名 为 xmlhttprequest 的 项 目 就 是 起 这 个 作用 的 。 


在 其 他 的 场景 中 ， 某 些 模块 只 和 原生 API 交 互 ， 这 类 代码 就 很 容易 写成 可 以 在 两 个 环境 中 


运行 。 


这 类 例子 如 下 所 示 。 

= 日 期 操作 工具 集 : 它们 通常 简单 地 处 理 原 生 Date API 或 者 对 其 做 相应 扩展 。 

= 模板 引擎 : 它们 通常 接收 一 个 字符 串 ， 通 过 正则 表达 式 或 者 循环 来 解析 ， 并 生成 一 个 
(编译 ) 函数 ， 用 于 输出 编译 后 的 字符 串 。 

" 数学 及 加 密 库 : 它们 通常 处 理 Number 和 与 数学 相关 的 内 容 。 

" 面向 对 象 框 架 : 它们 提供 一 些 在 JavaScript 中 书写 类 的 语法 糖 。 换 句 话 说， 提供 一 些 
API， 使 得 在 JavaScript 中 能 和 在 其 他 典型 的 面向 对 象 语言 中 一 样 书写 面向 对 象 代码 。 


书写 兼容 的 JavaScript 代 码 


第 一 个 挑战 就 是 要 解决 在 Node.js 模 块 系统 中 书写 的 JavaScript 代 码 无 法 在 浏览 器 中 运行 的 


问题 。 
导出 模块 


让 它 


MH, 


第 一 个 问题 是 浏览 器 环境 中 没有 module 全 局 变量 。 哪 怕 文 件 本 身 没有 依赖 ,但 是 ， 要 想 
能 为 其 他 Node 程 序 所 用 ， 需 要 通过 module .exports 或 者 exports。 


假设 ,我 们 已 熟悉 一 个 简单 的 两 数 求 和 的 函数 : 





add.is 


module.exports = function (a, b) { 
return a + b; 
} 











在 Node 中 ， 只 需 简单 地 从 另外 一 个 文件 中 调用 require (' . /add' ) 就 可 以 了 。 在 浏览 器 
我 们 更 希望 将 其 暴露 为 一 个 全 局 变量 add。 


为 了 避免 修改 已 有 代码 ， 我 们 可 以 在 浏览 器 中 ， 通 过 伪造 一 个 module 对 象 来 模拟 


module.exports: 
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if ('undefined' == typeof module) { 
module = { exports: {} }; 


} 
模块 代码 的 最 后 ， 对 象 生 成 后 ， 就 可 以 将 其 暴露 给 window 全 局 对 象 了 。 


if ('undefined' != typeof window) { 
window.add = module.exports; 


} 


和 Node.js 不 同 ， 在 浏览 器 中 ,文件 都 是 在 全 局 作用 于 下 执行 的 。 因 此 ， 我 们 需要 为 程序 
引入 一 个 全 局 的 module 变 量 。 


将 模块 代码 包 右 在 一 个 自 执行 的 函数 中 是 个 不 错 的 主意 。 


(function (module) { 
module.exports = function (a, b) { 
return a + b; 


} 


if ('undefined' != typeof window) { 
window.add = module.exports; 


) 


}) (‘undefined' == typeof module ? ( module: { exports: {} ) } : module); 
太 好 了 ! 模块 还 是 可 以 通过 require 获 得 : 
$ node 


> require('./add') (1,2) 
3 


同时 ， 还 能 在 DOM 中 引入 : 





a EE SPR Roe SS 


add.html 


«script src="add.js"><script> 
«script» 

console.log(add(1,2)); 
«/script» 





模拟 实现 ECMA API 
下 一 个 挑战 就 是 ， 一 些 主流 浏览 器 中 的 特性 在 其 他 浏览 器 及 JavaScript 引 擎 中 都 没有 。 
有 时 ，Node 中 的 v8 引擎 甚至 比 诸多 电脑 所 用 的 Google Chrome 浏 览 器 的 引擎 还 要 新 。 然 


而 ， 对 于 Function#bind 这 样 的 API， 一 些 主流 引擎 ， 如 Safari 引 擎 JavaScriptCore VM 就 还 不 
支持 。 所 以 ， 要 想 让 代码 处 处 运行 ， 对 于 使 用 了 哪些 功能 要 特别 小 心 。 


对 于 缺失 的 这 类 功能 ， 有 两 个 解决 办 法 : 通过 扩展 原型 来 提供 这 类 功能 的 实现 或 者 使 用 工 
RR 
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扩展 原型 
假设 我 们 书写 了 一 个 同时 在 Node 和 浏览 器 中 运行 的 模块 ， 它 用 到 了 Function#bind 方 法 。 


var myfn = fn.bind(this) ; 
由 于 bind 方 法 并 不 一 定 在 所 有 环境 中 都 存在 ， 所 以 当 它 不 存在 时 ， 我 们 要 创建 一 个 出 来 : 


if (!Function.prototype.bind) { 
Function.prototype.bind = function () { 
// code that replicates bind behavior 
) 
) 


有 一 个 名 为 es5-shim 的 项 目 做 了 类 似 上 面 的 事情 ， 它 把 所 有 浏览 器 中 缺少 的 ECMA 标 准 API 
都 实现 了 。 要 了 人 解 该 项 目 详情 ， 可 以 参考 https://github.com/kriskowal/es5-shim。 


这 种 技术 有 个 很 明显 的 好 处 就 是 在 加 入 填补 的 方法 后 ， 几 乎 不 需要 修改 源 代 码 。 
缺点 就 是 这 么 做 会 破坏 原型 对 象 ， 影 响 其 他 使 用 者 ， 可 能 还 会 更 糟 。 
工具 函数 


另 一 种 解决 方法 就 是 定义 简单 的 函数 ， 接 收 原生 对 象 作为 参数 ， 如 果 该 对 象 上 的 函数 已 经 
实现 了 ， 就 直接 使 用 ， 和 否则 就 实现 一 次 。 


例如 ,Object .keys 就 是 个 很 好 的 例子 ， 在 Node 中 会 经 常 使 用 此 函数 ， 但 是 在 很 多 浏览 


器 中 却 还 没有 提供 其 实现 。 
接着 ， 我 们 就 通过 如 下 方式 来 定义 一 个 工具 函数 : 
var keys = Object.keys || function (obj) { 
var ret = []; 


for (var i in obj) { 
if (Object.prototype.hasOwnProperty.call(obj, i)) { 
ret.push(i); 
} 
} 
return ret; 
HE 


这 种 技术 的 好 处 就 是 随处 都 能 用 ， 没 有 隐患 ， 并 且 对 于 开发 者 来 说 ， 能 够 一 眼 就 看 明白 哪 
些 方法 是 模拟 的 ， 哪 些 是 原生 的 ， 这 对 于 在 某 些 浏览 器 中 检测 代码 性 能 很 有 帮助 。 


缺点 就 是 ， 我 们 要 记 住 是 用 工具 函数 而 不 是 用 原生 的 。 


除 此 之 外 ， 有 的 时 候 ， 最 终 书写 出 来 的 代码 会 有 些 完 长 。 比 如 ， 旧 版 本 的 IE 不 支持 
Array#forEach、Array#map 及 Array#filter， 要 想 写 出 兼容 的 代码 ， 可 能 要 写成 如 下 形式 . 
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arr.filter(function () {}).map(function(){ )).forEach(function () () 
不 过 ， 上 述 代码 远 没 有 使 用 工具 函数 来 得 清 


each(map(filter(arr, function() {}), function () {}), function ()()) 


模拟 实现 Node API 
有 些 如 EventEmitter 这 样 的 Node API 一 般 会 在 自 定义 的 类 中 使 用 。 幸 运 的 是 ，Node 社 
区 书写 了 可 以 在 所 有 环境 下 运行 的 Node API。 
EventEmitter 
对 node EventEmitter 的 实现 可 以 参考 https://github.com/Wolfy87/EventEmitter 和 https:// 
github.com/tmpvar/node-eventemitter。 


assert 


支持 浏览 胡 的 assert 模 块 可 以 在 这 里 找到 : https://github.com/Jxck/assert。 


模拟 实现 浏览 器 疡 API 
很 多 情况 下 ， 我 们 希望 在 Node 中 也 能 运行 浏览 器 支持 的 方法 。 


XMLHttpRequest 


node-XMLHttpRequestJJi H ( https://github.com/driverdan/node-XMLHttpRequest ) 为 Node 提 
供 了 XMLHttpRequest 的 模拟 实现 ， 通 过 如 下 方式 就 可 以 引入 该 模块 了 : 


var XMLHttpRequest = require('xmlhttprequest' ) 


DOM 

一 个 完整 并 且 测 试 完 全 的 DOM I, DOM II 以 及 DOM III 的 实现 在 这 里 : https://github.com/ 
tmpvar/jsdom. 

WebSocket 

Node 中 也 有 WebSocket 客 户 端的 API 实 现 ( https://github.com/einaros/ws ) : 


Var WebSocket = require('ws') 


node-canvas 


用 于 图 片 操作 的 2D 画 布 上 下 文 也 有 在 Node 中 的 实现 ， 参 考 node-canvas: https://github.com/ 


learnboost/node-canvas。 
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寺 浏 览 器 的 继承 实现 
在 模块 中 ， 经 常 需要 将 一 个 类 继承 自 另 一 个 类 。 第 2 章 中 介绍 的 .proto “可 以 用 于 实 
现 继承 ， 但 却 很 难 模拟 实现 。 


一 个 简单 的 解决 方法 是 通过 如 下 方式 定义 一 个 工具 函数 : 
J** 

* 用 于 实现 继承 的 工具 函数 

* @param (Function) 构造 器 


* @param (Function) 父 类 构造 器 
* @api private 
* 4 


function inherits (a, b) ( 
function c () (); 
c.prototype - b.prototype; 
a.prototype - new c; 


}; 


然后 就 可 以 在 Node 和 浏览 器 中 使 用 了 。 


function A () {} 
function B () {} 


inherits(A, B); 
// instead of A.prototype.__proto__ = B.prototype 


集成 到 一 起 . browserbuild 

通过 自 执行 函数 将 模块 代码 包 于 起来， 同时 到 处 都 得 执行 typeof 检 测 多 少 有 点 麻烦 。 

我 创建 了 一 个 名 为 browserbuild 的 项 目 ， 它 的 作用 就 是 将 以 Node 风 格 书写 的 代码 C BI 
使 用 了 require、module.exports 以 及 exports， 并 且 代 码 都 分 属 不 同文 件 ) ， 通 过 运行 
简单 的 命令 ， 就 编译 为 浏览 器 端 可 执行 的 版 本 。 

browserbuild 可 以 允许 你 以 Node 风 格 书写 此 前 的 求 和 模块 ， 通 过 编译 后 ， 就 会 生成 一 个 可 
JAREN V de mL E «script» AU BU BUS s 

browserbuild 同 时 还 是 个 NPM 模 块 ， 它 提供 了 browserbui1lg 命 令 行 脚本 。 要 全 局 安装 该 
模块 ， 可 以 采用 如 下 方式 : 


npm install -g browserbuild 


browserbuild --version 


上 述 第 二 行 命令 用 于 展示 所 安装 browserbuild 的 版 本 号 。 这 里 所 用 的 版 本 号 是 0.4.8。 
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还 可 以 直接 安装 到 工作 目录 中 ,通过 .bin 目录 来 访问 : 


npm install browserbuild 
./node modules/browserbuild/.bin/browserbuild --version 


基础 案例 
本 例 中 ,我们 要 书写 一 个 模块 ， 该 模块 依赖 于 日 志 工具 。 


首先 ， 书 写 一 个 main.js 文 件 : 





main.js 
var log - require('./log'): 
module.exports - function () ( 


log('Executed my module'); 
) 


在 使 用 特定 模块 时 ，main 文 件 不 管 是 在 NPM 模 块 系统 中 ， 还 是 在 单独 的 文件 中 ， 都 可 以 
通过 require 来 引入 。 


log.js 
module.exports - function (str) ( 
return console.log(str); 


) 


在 Node 中 ， 可 以 直接 写成 ; 


node.js 
var mymodule = require('./main') 


mymodule(); 





对 于 浏览 器 端 ， 我 们 需要 其 导出 成 全 局 的 mymodule 变 量 。 所 以 ， 我 们 需要 在 工作 目录 下 
运行 browserbuild 命 令 ， 同 时 提供 全 局 变量 名 以 及 main 文 件 。 


browserbuild --main main --global mymodule main.js log.js > out.js. 

上 述 代 码 的 含义 是 告诉 browserbuild: 编译 main.js 和 1log.js， 并 将 main 模 块 导 出 
为 nymodule 全 局 变量 。 

除 此 之 外 , 注意 ， 命 令 行 最 后 我 们 使 用 了 >compiled.js。 这 是 将 输出 的 结果 保存 到 
compiled.js 文 件 中 。 


要 将 其 作为 库 引入 到 浏览 器 中 ， 只 需 添加 一 个 <script> 标 签 ， 并 指向 compiled .js 脚 
本 即 可 ; 
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<script src='compiled.js"> 


287 生成 的 脚本 如 下 所 示 : 





compiled.js 

(function() {var global = this;function debug() {return debug);function require (p, 
parent)( var path - require.resolve(p) , mod - require.modules[path]; if (!mod) 
throw new Error('failed to require "' +p + '" from ' + parent); if (!mod.exports) 
( mod.exports - (); mod.call(mod.exports, mod, mod.exports, require.relative(path), 


global); ) return mod.exports;)require.modules - ();require.resolve - 
function(path)( var orig = path , reg = path + '.js' , index = path + '/index.js'; 
return require.modules[reg] && reg || require.modules[index] && index || 
orig;);require.register = function(path, fn){ require.modules[path] = fn;};require. 
relative = function(parent) { return function(p){ if ('debug' == p) return debug; 
if ('.' != p.charAt(0)) return require(p); var path = parent.split('/') , segs = 
p.split('/'); path.pop(); for (var i = 0; i « segs.length; i++) ( var seg = 
segs[i]; if ('..' == seg) path.pop(); else if ('.' != seg) path.push(seg); ) return 
require(path.join('/'), parent); };};require.register("main.js", function(module, 


exports, require, global)( 
var log = require('./log'); 
module.exports = function () ( 


log('Executed my module'); 


));require.register("log.js", function(module, exports, require, global)( 
module.exports - function (str) ( 


return console.log(str); 


));mymodule - require('main'); 
))0; 





上 述 脚本 中 ， 第 一 部 分 实现 了 一 个 require 函 数 供 后 续 代码 使 用 。 编 译 后 的 脚本 全 部 压 
缩 在 一 行 代码 中 ， 这 样 文件 长 度 对 于 编译 过 程 的 影响 可 以 减 到 最 小 。 


男 一 部 分 比较 有 意思 的 代码 是 ，require .register 函 数 提 供 了 一 个 global 参 数 。 这 
样 做 是 为 了 避免 你 去 检测 window 对 象 是 否 存 在 ， 以 此 来 提供 男 一 个 global 变 量 。 书 写 代码 
时 可 以 直接 看 作 是 Node.js 的 91obal 对 象 ， 要 是 在 浏览 器 中 ， 该 对 象 会 变 成 window 对 象 。 


最 后 ， 上 述 代码 的 最 后 一 部 分 是 导出 了 全 局 变量 (mymodule) ， 这 也 解释 了 运行 browserbuild 
的 时 候 要 指定 是 main 模 块 的 原因 : 


mymodule = require('main'); 
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browserbuild 另 一 个 有 意思 的 特性 是 if _ node 代码 块 ， 它 允许 你 使 用 JavaScript 注 释 来 告诉 
编译 器 ， 该 代码 块 中 的 代码 不 需要 编译 到 浏览 器 端 版 本 中 : 





nodeonly.is 
// if node 


process.exit(1); 
// end 


console.log('browser and node'); 


如 果 运 行 如 下 命令 编译 上 述 代码 ，if node 代 码 块 中 的 代码 就 不 会 被 编译 进去 : 
$ browserbuild --main nodeonly nodeonly.js 


你 会 注意 到 process .exit 代 码 行 不 在 里 面 。 


LP a 

require.register("nodeonly.js", function(module, exports, require, global) { 
console.log('browser and node'); 

));nodeonly = require('nodeonly'); 

WO: 


要 获取 更 多 browserbuild 命 令 的 选项 ， 可 以 执行 prowserbuild --help, 或 者 参看 项 目 
主页 : http://github.com/learnboost/browserbuild。 


小 结 


正如 全 书 一 直 在 强调 的 ，Node.js 做 了 一 项 很 伟大 的 工作 就 是 将 JavaScript 带 到 了 服务 器 
Sift o 


这 一 创新 依赖 于 其 模块 系统 ， 而 浏览 器 端 则 没有 对 应 的 默认 模块 系统 。 


本 章 从 介绍 如 何 利 用 运行 时 的 方法 检测 来 书写 同时 能 在 服务 器 端 和 浏览 器 端 运行 的 代码 。 
通过 执行 typeof 检 查 ， 可 以 实现 模块 系统 的 特性 检查 ， 并 为 浏览 器 端 也 提供 一 个 导出 机 制 ， 
比如 通过 全 局 对 象 。 


然而 ， 在 所 有 的 文件 中 都 要 进行 手动 地 通过 自 执行 的 函数 将 代码 包 庄 起 来 ， 并 执行 typeof 
进行 检查 ， 这 显然 有 悖 于 Node 中 require 系 统 的 简洁 性 ，browserbuild 就 是 为 了 解决 这 类 问 
题 而 生 的 。 有 了 它 ， 就 可 以 很 轻松 地 书写 Nodejs 模 块 ， 并 编译 到 浏览 器 端 进行 运行 了 。 

这 种 方法 的 显著 的 好 处 就 是 ， 模 块 是 完全 以 全 局 变量 的 方式 在 浏览 器 端 导出 的 ， 就 和 
jQuery 和 IO 一 样 ， 也 就 是 说 ， 并 没有 引入 一 个 特定 的 模块 系统 API 来 让 终端 用 户 在 浏览 器 环境 
中 使 用 。 
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测试 


至 此 ， 每 次 书写 完 Node 程 序 ， 都 要 通过 执行 程序 来 检测 是 否 结果 和 我 们 预期 的 一 样 ， 从 
而 判断 工作 是 否 正常 。 随 着 时 间 越 来 越 长 ， 这 种 确保 程序 工作 正常 并 且 没 有 引入 新 bug 的 测试 
方法 是 非常 低 效 的 。 

自动 化 测试 是 一 个 过 程 ， 它 通过 执行 一 系列 程序 来 检验 函数 工作 是 否 正 确 。 本 章 首 先 要 介 
绍 的 自动 化 测试 的 方法 是 为 每 个 测试 创建 一 段 小 的 node 程 序 ， 然 后 使 用 原生 的 assert 模 块 来 
检验 。 

接着 ,我 们 会 通过 使 用 一 个 名 为 expect.js 的 项 目 来 优化 书写 断言 Cassertion ) 的 过 程 。 紧 
接着 ， 我 们 还 会 介绍 如 何 使 用 测试 框架 Mocha 来 组 织 测试 代码 。 

最 后 ， 对 于 在 Node 和 浏览 器 端 都 要 运行 的 代码 ， 本 章 会 介绍 如 何 将 已 有 的 测试 也 用 到 浏 
览 器 端 。 


简单 测试 
开始 前 ， 我 们 先 要 确定 测试 目标 。 换 句 话 说 ， 我 们 得 确定 哪些 脚本 或 者 功能 需要 测试 。 
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测试 目标 

本 章 的 测试 目标 是 我 们 在 第 9 章 中 书写 的 查询 推 文 的 应 用 

这 里 ， 我 们 书写 一 个 程序 ,来 断言 提交 查询 时 ， 看 看 是 否 能 够 找到 对 应 的 HTML 代 码 来 证 
明 查 询 的 推 文 内 容 返回 了 。 本 例子 ， 推广 列表 是 通过 一 个 或 者 多 个 <1i> 元 素来 构建 的 。 通 过 
断言 查询 关键 字 是 否 存在 ， 以 及 <1i> 字 符 串 是 否 为 HTTP 响 应 内 容 的 一 部 分 来 判断 应 用 程序 是 
否 工 作 正 常 ， 应 当 已 经 很 充分 了 。 

始 自动 化 测试 前 ， 我 们 先 运行 应 用 ， 确 保 它 能 正常 工作 。 然 后 ， 通 过 浏览 器 访问 

http://localhost:3000, 


测试 策略 

最 基本 的 测试 方法 就 是 书写 一 个 新 的 node 程 序 ， 当 测试 通过 时 就 以 状态 码 0 退出 程序 ， 失 
败 则 以 状态 码 1 退出 。 

如 果 有 未 捕获 的 异常 (uncaught exception ) 抛 出 ，Node 会 自动 以 失败 错误 码 退 出 程序 ， 和 我 
们 的 设计 相符 。 除 此 之 外 ， 还 能 获得 堆栈 踪迹 来 帮助 调试 错误 原因 。 因 此 ， 书 写 测试 代码 时 ， 
目标 就 是 要 断言 条 件 是 否 通 过 ， 不 通过 就 抛 出 异常 。Node 自 带 了 一 个 assert 模 块 ， 顾 名 思 义 ， 
它 的 作用 就 是 检查 判断 条 件 是 否 通过 ， 如 果 不 通 过 ， 就 抛 出 一 个 AssertionError 异 常 。 


作为 例子 ， 我 们 书写 一 个 测试 程序 ， 当 时 间 惟 是 偶数 时 成 功 ， 是 奇数 时 失败 ， 同 时 抛 出 堆 
栈 信息 。 











i 块 依赖 
Sy 
var assert = require('assert'); 
/** 
* 断言 条 件 
"y 
var now - Date.now(); 


console.log (now); 
assert.ok(now % 2 == 0); 


assert .ok 可 以 用 来 判断 提供 的 值 是 否 为 真 (哪怕 真是 值 不 是 Erue， 我 们 还 是 要 断言 它 
是 true ) 。 当 数字 除 以 2 没有 余数 时 ， 那 么 该 数字 就 是 偶数 。 


现在 ， 我 们 多 运行 几 次 上 述 程序 ， 看 看 时 间 戳 : 
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æ simple-testing node assert-example.js 
1325520251830 
o simple-testing node assert-example.js 
1325520252742 
æ simple-testing node assert-example.js 
1325520253637 


node.js:134 
throw e; // process.nextTick error, or 'error' event on first tick 


AssertionError: true -- false 
at Object.«anonymous» (assert-example.js:14:8) 
at Module. compile (module.js:411:26) 
at Object..js (module.js:417:10) 
at Module.load (module.js:343:31) 
at Function. load (module.js:302:12) 
at Array.«anonymous» (module.js:430:10) 
at EventEmitter. tickCallback (node.js:126:26) 


前 两 次 中 ， 由 于 时 间 戳 是 偶数 ， 所 以 测试 通过 了 。 第 三 次 ， 时 间 戳 变 成 了 奇数 ， 所 以 抛 出 
了 异常 ， 输 出 了 堆栈 信息 。 


测试 程序 
现在 ,我 们 使 用 superagent， 发送 GET 请 求 来 查询 pieber 关 键 字 ， 然 后 分 析 响 应 结果 : 


/** 


* 模块 依赖 


"y 


var request - require('superagent') 
, assert - require('assert') 


/** 
* 测试 /search?q=<tweet> 
sj 


request.get('http://localhost:3000') 
.data(( q: 'bieber' )) 
.exec(function (res) ( 


/7 断言 响应 状态 码 是 否 正确 


assert.ok(200 == res.status) ; 


// 断言 关键 字 是 否 存在 


assert .ok(~res.text.toLowerCase() .indexOf('bieber')); 


// 断言 列表 项 是 否 存在 
assert .ok(~res.text.indexOf('<li>')); 
)); 
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= throwException: 断言 Eunction 在 调用 时 是 否 会 抛 出 异常 。 


expect (fn) .to.throwException () ; 
expect (fn2) .to.not.throwException () ; 


* within; 断言 数组 是 否 在 某 个 区 间 内 。 

expect (1).to.be.within(0, Infinity); 
=" greaterThan/above: 断言 >。 

expect (3) .to.be.above(0); expect(5) .to.be.greaterThan (3) ; 
* lessThan/below: 断言 <。 

expect (0).to.be.below(3); expect (1).to.be.lessThan (3) ; 


改进 了 断言 风格 ， 接 下 来 ， 我 们 要 通过 一 个 名 为 Mocha 的 框架 重 构 测 试 代码 的 组 织 方式 。 


Mocha 


Mocha 是 一 个 测试 框架 ， 简 化 了 书写 测试 代码 的 过 程 ， 提 供 划 分 测试 集 、 运 行 并 同时 输出 
有 助 于 开发 者 理解 的 结果 页 。 


相 比 把 一 份 份 测试 代码 写 在 不 同文 件 中 ， 会 导致 的 文件 系统 中 存 有 大 量 无 序 文件 ， 通 过 
Mocha， 可 以 书写 出 如 下 形式 的 测试 代码 : 


test.js 
describe('a topic', function () { 
it('should test something', function () { 
)); 
describe('another topic', function () ( 
it('should test something else', function () ( 


与 expectjs 类 似 ， 在 testjs 中 描述 和 组 织 测试 代码 的 方式 非常 自然 直观 。 


—4— 


要 运行 测试 代码 只 需 通 过 mocha 命 令 即 可 。 在 这 之 前 ， 需 要 确保 运行 hpm install -g 
mocha 安 装 了 mocha。 然 后 ， 就 通过 如 下 方式 来 运行 : 
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be/equal; 类 似 » 


expect(1).to.be(1); 

expect (NaN) .not.to.equal (NaN) ; 
expect (1) .not.to.be(true) ; 
expect ('1').to.not.be(1); 


eql: 断言 非 严格 相等 ， 支 持 对 象 。 


expect(( a: 'b' )).to.egl(( a: 'b' }); 
expect(1).to.eqg1('1'); 


a/an: 断言 所 属 类 型 ， 支 持 数组 和 instanceof。 


// typeof with optional array 

expect (5) .to.be.a('number') ; 

expect ([]).to.be.an('array'); // works 

expect ([]).to.be.an('object'); // works too, since it uses typeof^ 
// constructors 

expect (5) .to.be.a (Number) ; 
expect ([]).to.be.an (Array) ; 
expect (tobi) .to.be.a(Ferret) ; 
expect (person) .to.be.a (Mammal) ; 


match: 断言 字符 串 是 否 匹 配 一 段 正则 表达 式 。 
expect (program.version) .to.match(/[0-9]+\.[0-9]+\.[0-9]+/); 


contain; 断言 字符 串 是 否 包 含 男 一 个 字符 串 ， 内 部 使 用 index0f 方 法 。 


expect([1, 2]).to.contain(1); 
expect('hello world').to.contain('world'); 


length; 断言 数组 长 度 ， 内 部 使 用 . Length 方 法 。 


expect([]) .to.have.length(0) ; 
expect ([1,2,3]).to.have.length(3) ; 


empty: 断言 数组 是 否 为 空 。 


expect ([]) .to.be.empty(): 
expect ([1,2,3]).to.not.be.empty() ; 


property: 断言 某 个 自身 属性 RE) 是 否 存在 。 


expect (window) .to.have.property('expect') ;expect (window) .to.have. 
property('expect', expect) 
expect((a: ‘b’}).to.have.property (‘a’); 


key/keys: 断言 键 是 否 存在 ， 支 持 on1y 修 饰 符 。 


js expect({ a: 'b' }).to.have.key('a'); 

expect({ a: 'b', c: 'd' )).to.only.have.keys('a', 'c'); 
expect({ a: 'b', c: 'd' }).to.only.have.keys(['a', 'c']); 
expect({ a: 'b', c: 'd' )).to.not.only.have.key('a'); 
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注意 了 ， 如 果 请 求 抛 出 异常 ， 我 们 直接 不 做 处 理 ， 往 上 抛 即 可 ， 最 终 它 会 变 成 一 个 未 捕获 
的 异常 ， 导 致 程序 失败 并 退出 。 
记 住 在 运行 测试 前 要 先 安 装 superagent: 


npm install superagent@0.4.1 


expect.js 
在 此 前 的 例子 中 ,我 们 使 用 了 assert .ok 以 及 基本 的 JavaScript 表 达 式 。 


在 看 测试 代码 时 ， 你 也 许 会 发 现 很 难看 懂 到 底 在 测试 什么 。 比 如 ， 断 言 一 个 字符 串 是 否 包 
含 另 一 个 字符 串 时 ， 最 简单 的 方法 就 是 使 用 indexof 方 法 和 ~ 操作 符 ， 正 如 此 前 例子 中 处 理 的 
那样 。 


expectjs 提 供 了 一 个 简单 的 expect 函 数 ， 可 以 将 : 

assert.ok(-res.text.indexOf('«1li»')); 

改写 成 : 

expect (res. text) .£ó.containi '«1i»')); 

通过 近 自 然 语 言 的 表达 ， 使 得 书写 和 理解 测试 代码 变 得 更 加 容易 。 

expect.js 可 以 通过 NPM 获 取 ， 其 名 为 expect .js， 同 时， 它 的 官方 文档 是 https://github. 


com/learnboost/expect.js. 


接 下 来 ， 会 介绍 一 些 expectjs 的 基础 API。 


API 一 览 
通过 引入 expectjs 模 块 就 可 以 使 用 expect 函 数 : 
var expect = require('expect.js') 
expect.js 可 以 和 任何 模块 一 起 使 用 ， 如 此 前 用 到 的 assert。 与 所 有 assert 模 块 提供 的 也 
数 类 似 ， 在 expect.js 中 ， 当 断言 失败 时 会 抛 出 AssertionError。 
下 面 是 一 些 expect.js 0.1.2 中 最 有 用 的 方法 。 
= ok; 断言 值 是 否 为 真 。 


expect (1) .to.be.ok(); 
expect (true) .to.be.ok(); 
expect ({}) .to.be.ok(); 
expect (0) .to.not.be.ok(); 
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mocha test.js 
Mocha 使 用 多 种 报告 形式 来 展示 测试 通过 和 运行 结果 。 


mocha test.js 


hà 


tests complete (0ms) 


比如 ， 有 种 报告 形式 是 列表 : 


mocha -R list test.js 


a topic should test something: Oms 
a topic another topic should test something else: Oms 


2 tests complete (lms) 


正如 下 面 将 要 介绍 的 ，Mocha 还 有 一 种 HTML 报 告 形 式 ， 可 以 让 你 直接 在 浏览 器 查看 运 


一 


1To 


测试 异步 代码 
Mocha 默 认 会 在 一 个 测试 用 例 执行 完毕 后 立刻 执行 男 一 个 。 然 而 ， 很 多 时 候 ， 当 有 异步 事 
件 发 生 时 ,我们 希望 能 够 延缓 下 一 个 测试 用 例 的 执行 。 


考虑 如 下 例子 : 
it('should not throw', function () { 
setTimeout (function () { 


throw new Error('An error!'); 
), 100); 
)); 


上 述 测试 代码 总 会 通过 。 原 因 就 在 于 设置 了 计时 器 后 代码 就 执行 完毕 了 ，Mocha 会 继续 去 
执行 下 一 个 。 由 于 在 计时 器 设置 后 ， 没 有 立刻 抛 出 异常 ， 所 以 测试 通过 。 


对 于 这 类 异常 要 在 将 来 才 会 抛 出 ( 异步 的 行为 ) 的 测试 ， 我 们 需要 告诉 Mocha， 等 到 我 们 
通知 它 说 完成 了 才能 认为 该 测试 完成 了 。 

要 解决 这 个 问题 ,我们 只 要 简单 地 在 回调 函数 中 添加 一 个 参数 就 可 以 了 。 也 就 是 说 ， 正 如 
第 2 章 中 介绍 的 ， 我 们 将 函数 的 参数 数量 (或 者 是 function#length ) 设置 为 1: 


it('should not throw’, function (done) { 
setTimeout (function () { 
assert.ok(1 == 1); 
), 100); 
)); 
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现在 ， 测 试 代码 看 起 来 就 像 中 间 件 一 样 。Mocha 会 一 直 等 到 done 函 数 调 用 之 后 才 sins 
该 测试 已 经 结束 。 如 果 该 函数 在 两 秒 内 ( 默认 ) BOA IAA, ERR — “SI ERE 
个 测试 卡 住 了 。 你 也 可 以 通过 mocha 命 令 的 -t 选 项 来 修改 这 个 超时 时 长 。 wa 


式 来 自 定义 超时 时 长 : 


it('will fail', function () { 
this.timeout(100); 
setTimeout(function () ( 
// the test will timeout before this occurs 
), 1000); 
}); 


为 了 让 这 个 测试 用 例 能 够 工作 ， 我 们 在 断言 结束 后 调用 done 方 法 : 


it('should not throw', function (done) { 


setTimeout (function () ( 
assert.ok(1 == 1); 
done () ; 

}, 100); 


4 
我 们 可 以 使 用 Mocha 将 此 前 测试 查询 Bieber 推 文 应 用 的 代码 改写 为 如 下 形式 : 


it('should find bieber tweets', function (done) { 
request.get('http://localhost:3000') 
.data(( q: 'bieber' }) 


.exec(function (res) ( 


// 断言 状态 码 是 否 正确 


assert.ok(200 == res.status) ; 


// 断言 查询 关键 字 是 否 存 在 


assert.ok(-res.text.toLowerCase().indexOf('bieber')); 


// 断言 列表 项 是 否 存在 


assert.ok(-res.text.indexOf('«li»')); 


done(); 
): 
)); 


有 时 ， 一 个 测试 用 例 只 有 在 当 多 个 异步 操作 一 起 完成 时 才 算 通过 。 
这 时 我 们 就 可 以 使 用 一 个 计数 器 来 解决 这 个 问题 : 


it('should complete three requests', function (done) { 
var total = 3; 
request.get('http://localhost:3000/1', function (res) ( 
if (200 !- res.status) throw new Error('Request error');--total || done(); 


dy): 
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request.get('http://localhost:3000/2', function (res) { 
if (200 != res.status) throw new Error('Request error');--total || done(); 


)): 
request.get('http://localhost:3000/3', function (res) ( 
if (200 != res.status) throw new Error('Request error');; 
--total || done(); ` 
3: 
1); 


注意 了 ，Mocha 非 常 “聪明 ”， 它 能 够 识别 出 未 捕获 的 异常 属于 哪个 测试 用 例 。 这 是 因为 Mocha 
任何 时 候 只 执行 一 个 测试 用 例 ， 所 以 它 能 够 准确 地 将 通过 process.on ('uncaughtException') 
处 理 器 捕获 的 未 捕获 的 错误 (uncaught Exception ) 链接 到 正确 的 测试 用 例 上 。 


BDD 风 格 

前 面 小 节 中 使 用 的 测试 代码 书写 风格 称 为 : 行为 驱动 开发 ( BDD ) 。 

在 接 下 来 的 例子 中 ， 我 们 给 jade 提 供 一 个 包含 段落 的 模板 来 测试 Jade 的 处 理 行为 。 过 程 中 
还 会 用 到 expect.js。 

首先 ， 安 装 Jade 、Mocha 和 expect.js: 


$ npm install expect.js jade mocha 
bdd.js 
var expect - require('expect.js') 


, jade = require('jade'); 


describe('jade.render', function () ( 
it('should render a paragraph', function () ( 
expect(jade.render('p A paragraph')).to.be('«p»A paragraph«/p»'); 


)); 
)): 





由 于 Mocha 安 装 在 项 目 路 径 中 时 并 非 是 全 局 安装 ， 所 以 ， 要 在 . /node_modules/bin 找 到 
它 并 执行 : 
$ ./node_modules/.bin/mocha bdd.js 


TDD 
接 下 来 要 介绍 的 是 测试 驱动 开发 (TDD ) 。 它 和 BDD 类 似 ， 但 是 组 织 方式 是 使 用 测试 集 
(suite ) 和 测试 (test ) 。 
每 个 测试 集 都 有 setup 和 teardown 函 数 。 这 些 方法 会 在 测试 集中 的 测试 执行 前 执行 ， 它 们 的 
作用 是 为 了 避免 代码 重复 以 及 最 大 限度 使 得 测试 之 间 相 互 独立 。 
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现在 ,测试 代码 看 起 来 就 像 中 间 件 一 样 。Mocha 会 一 直 等 到 done 函 数 调用 之 后 才 会 认为 
该 测试 已 经 结束 。 如 果 该 函数 在 两 秒 内 (默认 ) 没有 调用 ， 就 会 抛 出 一 个 超时 异常 来 告诉 你 哪 
个 测试 卡 住 了 。 你 也 可 以 通过 mocha 命 令 的 -t 选 项 来 修改 这 个 超时 时 长 。 还 可 以 通过 如 下 方 


式 来 自 定义 超时 时 长 : 


it('will fail', function () { 
this.timeout (100); 
setTimeout (function () { 
// the test will timeout before this occurs 
}, 1000); 
Jt: 


为 了 让 这 个 测试 用 例 能 够 工作 ， 我 们 在 断言 结束 后 调用 done 方 法 : 


it('should not throw', function (done) { 


setTimeout (function () { 
assert.ok(1 == 1); 
done (); 

}, 100); 


)); 
我 们 可 以 使 用 Mocha 将 此 前 测试 查询 Bieber 推 文 应 用 的 代码 改写 为 如 下 形式 : 


it('should find bieber tweets', function (done) { 
request.get('http://localhost:3000') 
-data({ q: 'bieber' }) 
.exec(function (res) ( 


// 断言 状态 码 是 否 正确 


assert.ok(200 == res.status); 


// 断言 查询 关键 字 是 否 存 在 


assert.ok(-res.text.toLowerCase().indexOf('bieber')); 


// 断言 列表 项 是 否 存在 


assert .ok(~res.text.indexOf('<li>')); 


done (); 
}); 
}); 


有 时 ， 一 个 测试 用 例 只 有 在 当 多 个 异步 操作 一 起 完成 时 才 算 通过 。 
这 时 我 们 就 可 以 使 用 一 个 计数 器 来 解决 这 个 问题 : 


it('should complete three requests', function (done) ( 
var total - 3; 
request.get('http://localhost:3000/1', function (res) ( 
if (200 !- res.status) throw new Error('Request error');--total || done(); 
)); 


CHAPTER 16 + mh 283 


2 告诉 Mocha 采 用 什么 样 的 测试 风格 (TDD 、BDD 或 者 export ) 。 

3 载 入 测试 代码 。 

4 运行 Mocha。 

expectjs 可 以 在 所 有 浏览 器 中 运行 ， 它 可 以 很 好 地 和 Mocha 配 合 使 用 。 

建立 项 目 

我 们 从 创建 一 个 test/ 文 件 夹 开始 ， 该 文件 夹 包含 Mocha 在 浏览 器 端 运行 所 需 文件 


( mocha.css 和 mocha.js ) 。 


我 们 可 以 从 node_modules/mocha 目 录 中 将 这 两 个 文件 复制 过 来 ,或 者 从 git 仓 库 中 直接 
下 载 。 要 了 解 如 何 下 载 这 些 文件 ， 可 以 参考 http://mochajs.com。 


我 们 还 需要 载 人 jQuery 、expectjs 以 及 测试 代码 ， 然 后 调用 mocha. setup 来 设置 测试 风格 。 
最 终 ，test/index.html 代 码 如 下 所 示 : 





test/index.html 


<!doctype html> 
<html> 
<head> 
<title>my tests</title> 
<link href="/mocha.css" rel="stylesheet" media="screen" /> 
<script src="/jquery.js"></script> 
<script src="/mocha.js"></script> 
«script src="/expect.js"></script> 
<script>mocha.setup('bdd') ;</script> 
<script src="/my-test.js"></script> 
<script>window.onload = function () { mocha.run(); };</script> 
</head> 
<body> 
<div id="mocha"></div> 
</body> 
</html> 








如 上 述 代 码 所 示 ，Mocha 会 执行 my-test 文 件 ， 该 文件 中 以 BDD 的 风格 做 了 一 些 简单 的 测试 : 





my-test.js 
describe('my tests', function () ( 
it('should not throw', function () ( 


expect (1 + 1).to.be(2); 
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托管 目录 
最 简单 的 以 网 站 的 形式 托管 整个 目录 的 方式 是 使 用 serve (1) 命令 。 这 是 一 个 简单 的 命令 
行程 序 ，serve 内 部 使 用 connect 的 static 中 间 件 来 托管 指定 的 目录 : 


$ serve . 


之 后 ， 简 单 地 通过 浏览 器 访问 http://localhost:3000 就 可 以 了 。 


小 结 
本 章 一 开始 介绍 了 如 何以 最 简单 的 方式 书写 测试 程序 : 运行 一 个 简单 的 测试 脚本 并 查看 其 


运行 结果 是 否 成 功 。 
接着 ,为 了 验证 在 测试 脚本 中 ， 某 有 段 条 件 判断 是 否 通过 ， 本 章 介绍 了 一 个 Node.js 核 心 模 


块 assert。 

在 这 基础 上 ， 本 章 又 介绍 了 使 用 expect.js 和 Mocha 来 提升 测试 代码 风格 以 及 组 织 形式 。 
Expect 可 以 让 书写 的 测试 代码 清晰 易 履 ， 而 Mocha 提 供 了 很 好 的 组 织 测试 代码 的 方法 ， 同 时 还 
允许 将 测试 代码 在 浏览 器 端 运行 。 除 此 之 外 ， 对 于 测试 异步 代码 ， 也 游 妃 有余 。 
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Node .jS 是 一 个 由 JavaScript 书 写 而 成 的 强大 的 Web 开 发 框架 ， 它 让 开发 强壮 的 、 
伸缩 性 良好 的 服务 器 端 Web 应 用 变 得 更 加 简单 、 容 易 。 本 书 向 你 展示 了 什么 是 Node 以 
及 如 何 让 你 在 项 目 中 使 用 它 。 本 书包 含 大 量 实际 应 用 中 的 示例 程序 ， 证 明了 为 什么 
Node.js 会 快速 成 为 Web 开 发 首选 工具 ， 通 过 本 书 ， 你 能 够 快速 熟悉 和 掌握 达到 如 下 目 
标 所 需 的 Node 知 识 和 技能 

了解 Node 基 于 事件 轮 询 的 架构 、 无 阻塞 /O 以 及 事件 驱动 的 编程 方式 

: 精通 Node.js 的 API 

' 轻松 实现 开发 实时 应 用 相关 的 技术 ， 如 Socket.IO 和 HTML5 WebSocket 

: 编写 能 够 支持 跨 多 台 服 务 器 的 高 并 发 应 用 

' 通过 Node 来 支持 多 种 数据 库 以 及 数据 存储 工具 

: 编写 在 单 台 服 务 器 情况 下 能 够 处 理 万 级 并 发 量 的 程序 

: 能 够 在 一 个 包含 更 多 Node 知 识 和 注解 示例 ( 含 源 代码 ) 的 网 站 上 和 其 他 开发 者 进行 
实时 的 沟通 交流 
本 书包 含 大 量 全 彩 插图 和 实用 的 源 代 码 ， 绝 对 是 一 本 革命 性 Web 开 发 工具 一 一 Node 的 
实用 指南 。 


Guillermo Rauch ( 旧金山 ， 加 利 福 尼 亚 州 ) 是 一 家 位 于 旧金山 ， 为 当地 教育 提供 相关 
服务 的 创业 公司 LearnBoost 的 CTO 和 联合 创始 人 。Rauch 还 是 几 个 知名 Node.js 项 目的 
发 明 者 ， 曾 在 JSConf 和 一 些 Node.js workshop 做 过 演讲 。 





ISBN 978-7-121-21769-2 


WILEY 


策划 编辑 : KEM / 
责任 编辑 : mon ! 
nm: 封面 设计 : GEHE NN 





9 Tn 


定价 : 79.00 元 








